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PREFACE 


The SC/MP Assembly Language Programming Manual provides tutorial and reference information required for 
writing user application programs. Component data sheets and information pertaining to prototyping systems 
are available in other documents. 

It is suggested that the reader thoroughly review the table of contents, illustrations, and tables to familiarize 
himself with an overview of the organization of this manual before reading its contents. By so doing, the reader 
will have an understanding of the extent-of-coverage. 

This document supersedes the SC/MP Programming and Assembler Manual (Publication Number 4200094B). 
The material in this manual is for information purposes only and is subject to change without notice. 


Changes to this document will be reported in COMPUTE, the Microprocessor Users Group newsletter. 


Copies of this publication and other National Semiconductor publications may be obtained from the National 
Semiconductor sales office or distributor serving your locality. 


Reference publications: 


® SC/MP (FORTRAN) Cross Assembler Software Package, Installation and Operating Instructions 
(Publication Number 4200125) 
e SC/MP (IMP-16) Cross Assembler Operating Instructions (Publication Number 4200126) 


@ SC/MP (PACE) Cross Assembler Operating Instructions (Publication Number 420305238-001) 
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Chapter 1 
GENERAL INFORMATION 
SC/MP is a Simple Cost-effective MicroProcessor that affords the user with a powerful, versatile, and easy- 
to-use repertoire of instructions. These instructions are represented as simple mnemonics in the SC/MP 
assembly language. Writing user computer programs in this assembly language increases programming effi- 
ciency considerably. 
Other publications that pertain to the SC/MP Assembler are listed in the preface. 


The following is a brief description of the contents of chapter 2 through 7. 


Chapter 2, SC/MP Microprocessor Overview, describes the registers available to the user, the types of 
addressing used in SC/MP, and SC/MP input/output and interrupt facilities. 


Chapter 3, Assembly Language, describes the elements, the structure, and the coding conventions of the 
SC/MP Assembly Language. 


Chapter 4, Statements, is a detailed description of the characteristics and operation of the SC /MP instruction 
set. The chapter also describes four types of assembler-dependent statements: the comment, the pseudo- 


instruction, the assignment, and the directive. 


Chapter 5, Programming Techniques, provides programming examples that show how to write efficient code, 
how tc link to subroutines, and how to perform input/output (programmed and interrupt). 


Chapter 6, Macros, defines macros, what they are, how to use them, and how to write them. 


Chapter 7, Assembler Input/Output Formats, defines the input/output formats that are common to all SC/MP 
assemblers. 
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Chapter 2 


SC/MP MICROPROCESSOR OVERVIEW 


This chapter describes the main features of the SC/MP microprocessor. Only those features with which the 
programmer is primarily concerned are discussed. Detailed information on the SC/MP device is contained in 
the SC/MP Data Sheet. 


2.1 OPERATIONAL FEATURES 


The SC/MP is a programmable 8-bit parallel processor with 16-bit memory and peripheral addressing. Func- 
tionally, SC/MP has a bidirectional data bus connecting the CPU, memory, and peripheral devices. Peripheral 
devices are assigned memory addresses, and any standard memory-reference instruction can be used for 
input/output operations. Memory is expandable to 65,536 bytes. Table 2-1 lists the operational features of 
SC/MP. 


Table 2-1. Operational Features 


Data Length 8 Bits (Byte) 
Instruction Set 46 Instructions 


Arithmetic Parallel, binary, fixed point, twos complement 
2-digit BCD addition 


Memory Up to 65,536 bytes of ROM/RAM 


Registers One 8-bit Accumulator 
One 8-bit Status Register 
One 8-bit Extension Register 
Four 16-bit Pointer Registers (one is the Program Counter) 


Addressing Modes Program Counter Relative 
Indexed 
Auto-indexed 
Immediate 


Input/Output and Control 16-bit Address Bus: 4 multiplexed bits and 12 static bits 
8-bit Bidirectional Data Bus 


2.2 REGISTERS 


The seven registers available to the programmer who uses the SC/MP assembly language are shown in figure 2-1 
and are discussed in the following paragraphs. 


Accumulator (AC) 


Status Register (SR) 


Extension Register (E) 


Program Counter (PC) 
[Pointer Register 0(P0)] 


Pointer Register 1 (P1) 


Pointer Register 2 (P2) 


Pointer Register 3 (P3) 


Figure 2-1. SC/MP Registers 


2.2.1 Accumulator (AC) 


The 8-bit Accumulator (AC) is the primary working register of SC/MP. The accumulator is used in performing 
arithmetic and logic operations and for storing the results of those operations. Data transfers, shifts, and 
rotates also use the accumulator. In all, 37 of the 46 SC/MP instructions use the accumulator. 


2.2.2 Status Register (SR) 


The Status Register (SR) provides storage for arithmetic, control, and software status flags. The bit position 
and function of each flag in the register are shown and defined below. 


Bit Positions 


Flags 
Bit. Description 
0 User Flag 0 (F0). User assigned for contro] function or for software status. The output 
of this bit is available at a pin of the SC/MP device. 
1 User Flag 1 (Fl). Same as FO. 
2 User Flag 2 (F2). Same as FO. 
3 Interrupt Enable Flag (IE). The processor recognizes the interrupt input if this flag is set. 
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Bit Description 


4 Sense Bit A (SA). This bit is tied to a package pin and may be used to sense external 
conditions. This bit is "read-only"; thus, the Copy Accumulator to Status Register 
Instruction (CAS) does not affect this bit. When the Interrupt Enable Flag is set, Sense 
Bit A serves as the interrupt input. 


5) Sense Bit B (SB). Same as SA, except it is not used as an interrupt input. 
6 Overflow (OV). This bit is set if an arithmetic overflow occurs during an add (ADD, ADI, 


or ADE) or a complement-and-add instruction (CAD, CAI, or CAE). Overflow is not 
affected by the decimal-add instructions (DAD, DAI, or DAE). 


7 Carry/Link (CY/L). This bit is set if a carry from the most significant bit occurs during 
an add, a complement-and-add, or decimal-add instruction. The bit is also included in 
the Shift Right with Link (SRL) and the Rotate Right with Link (RRL) Instructions. CY/L 
is input as a carry into the bit 0 position of the add, complement-and-add, and decimal- 
add instructions. 


2.2.3 Extension Register (E) 


The 8-bit Extension Register (E) is used primarily with the accumulator to perform arithmetic, logic, and 
data-transfer operations. If the displacement in an indexed or an auto-indexed memory-reference instruction 
equals -128, (80,6). then the contents of E are substituted for the displacement for the given instruction. 


Another function of the Extension Register is serial input/output. This feature is explained in detail in the 
description of the Serial Input/Output Instruction (SIO) in chapter 4. 


2.2.4 Program Counter (PC) 


The Program Counter (PC) is the dedicated 16-bit Pointer Register PO. The Program Counter contains the 
address of the instruction being executed. In the event of an interrupt or a subroutine call, the contents of the 
Program Counter may be stored on a software stack and may be retrieved subsequently when the processor 
returns to the main program. The use of a software stack is explained in chapter 5. 


The Program Counter is incremented just before an instruction fetch. Therefore, the effective address of any 
transfer-of-control should be one less than the actual address to be executed (taking into account the modulo giz 
address arithmetic as explained in section 2.3). 


Arithmetic affecting the Program Counter is performed on the low-order 12 bits; the high-order 4 bits are not 
affected. A further explanation of this may be found in section 2.3. 


2.2.5 Pointer Registers (Pl, P2, P3) 


There are three 16-bit Pointer Registers available for addressing memory and peripherals, and for use as 
page pointers, stack pointers, or index registers. In simple applications the Pointer Registers might be used 
as temporary storage registers. Typically, the programmer assigns a specific function to each register. 

The following assignments might be used. 


Pl — ROM Pointer 
P2 — Stack Pointer 
P3 — Subroutine Pointer 


NOTE 


The SC/MP hardware uses Pointer Register 3 when 
servicing an interrupt. For details, see 2.5. 
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2.2.6 Inter-Register Data Flow 


Data flow relationships between memory and the seven registers of SC/MP are shown and described in figure 2-2. 


STATUS 
REGISTER 
(8 Bits) 


ACCUMULATOR EX TENSION (5) SERIAL INPUT 
REGISTER REGISTER 
(8 Bits) (8 Bits) (5 SERIAL OUTPUT 


MEMORY/ 
PERIPHERALS 


LEGEND: 


G) The low-order byte (bits 0-7) of any Pointer 

@ Register can be exchanged with the 8-bit 
Accumulator (XPAL). 

PROGRAM COUNTER 

(POINTER REGISTER 0) 

(16 Bits) 


(2) The high-order byte (bits 8-15) of any Pointer 
Register can be exchanged with the 8-bit 
Accumulator (X PAH). 


HIGH 
(Bits 8-15) 


LOW 


(3) The entire contents (bits 0-15) of Pointer 
(Bits 0-7) 


Register 0 (Program Counter) can be exchanged 
directly (without going through the Accumulator) 
with any of the other three Pointer Registers 


G) (XPPC). 


(4) The contents of the Accumulator can be ex- 
changed with the contents of the Extension 
Register (XAE), or the Accumulator can be 
loaded from the Extension Register (LDE). 


POINTER REGISTER 1 
(16 Bits) 


The data are serially shifted (one bit at a time) 
into and out of the Extension Register (SIO). 


(6) The contents of the Accumulator are copied 


HIGH 
(Bits 8-15) Bits 0. -7) |- 
POIN TER REGISTER 2 into the Status Register or vice versa (CAS 
(16 Bits) and CSA); the original contents of the destina- 
tion register are lost. (When the contents of 
HIGH the Accumulator are copied into the Status 
(Bits 8-15) Bits 0. -7) | Register, status bits 4 and 5 are not affected.) 


(7) As shown, all memory-reference data enter 
or leave the processing chain via the Accumu- 
lator. 


POINTER REGISTER 3 
(16 Bits) 
HIGH 
(Bits 8-15) Bits 0 “9 


Figure 2-2. Interrelationship of SC/MP Registers 
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2.3 MEMORY ORGANIZATION AND ADDRESSING 


Memory is organized as a sequence of 8-bit bytes. Each byte is identified by a 16-bit address that represents 
its sequential position in memory from 0 to FFFFyg¢ (65, 535 9). 


In the internal architecture of the computer, memory is divided into 16 pages (see figure 2-3). A page is a set 
of 4,096 consecutive bytes, the first byte of which is located ata memory address that is a multiple of 4,096. 
The 12 low-order bits of the address of the first byte of each page are zeros. Each memory address consists 
of a 4-bit address of the page and a 12-bit address within the page. 


16-BIT MEMORY ADDRESS 


12/11 
Address of Address man 
Page Page 
Ne ee ee ee 
000 0 
4K PAGE 0 
OO FFF 
100 0 
4K PAGE 1 
1 FFF 
64K 
E00 0 
4K PAGE 14 (X'E) © 
EFFFEF 
F 0 0 0 
4K PAGE 15 (X'F) 
F FFF 


Figure 2-3. Memory Organization 


2.3.1 Paging Considerations 


When performing arithmetic to calculate the effective address of an operand, the calculations are performed on 
the low-order (displacement) portion of the address with no carry into the high-order (page) portion. For example: 


Current Address Effective Address 


| Address Address Address 
of Page 


Displacement 
from 

Current 
Address 


Within Page Within Page 


Calculated 
Effective 

Address Remains 
Within Page 


Calculated 
Effective 

Address Crosses 
Page Boundary 


(wrap around) 


In the case when the calculated effective address crosses the page boundary of the current page, a ''wrap 
around" occurs. 


When incrementing the address to fetch the next instruction, the same page/displacement arithmetic occurs. 
If a 2-byte instruction is inadvertently separated by a page boundary, anerror occurs. Consider the following 


sequence of instructions on pages 0, 1, and 2 — with the first digit of the address designating the page and the 
next three digits, the location within the page. 


Address Instruction 

Page 0 
OFFF FF 
------+--+-----+~--------------- Page Boundary 
1000 81 
1001 AO 

Page 1 
IFFE DO 
1FFF Co 
wn en ee ee ee a Page Boundary 
2000 A2 | 

Page 2 


The instruction intended, when the PC = 1FFF (last word in page 1), is X'COA2 (LD X'20A2). However, instead 
of fetching the latter half of the instruction from page 2, a wrap-around is made to the first word of page 1; the 
instruction that will be executed is X'C081 (LD X'1081). The SC/MP assembler assumes the user will organize 
his programs in pages of 4,096 bytes for each page to provide protection from the situation described above. 

If a boundary cross-over occurs, the assembler issues an alarm message. 


If a user wants to start or continue a program from the beginning of a new page, he must explicitly set the loca- 
tion counter (see 4.4, Assignment Statement) and he must use the Jump to Subroutine (JS) pseudo instruction 
(see 4.3, Pseudo Instruction). For example: 


JS P3, PAGES 3J UMP TO PAGE 3 


PAGES: . =X'2000 


This example jumps to the first location of page 3. The user should be aware that the contents of the Accumulator 
are lost. 


283.2 Methods of Addressing 


During execution, instructions and data defined in a program are stored into and loaded from specific memory 
locations, the accumulator, or selected registers. Because the CPU, memory (read/write and read-only), and 
peripherals are on a common data bus, any instruction used to address memory may also be used to address the 
peripherals. The formats of the instruction groups that reference memory are shown below. 


displacement 
displacement 


Memory-reference instructions use the PC-relative, indexed, or auto-indexed methods of addressing memory. 
The memory increment/decrement instructions and the transfer instructions use the PC-relative or indexed 
methods of addressing. 


Memory Reference Instructions 


Memory Increment/Decrement 
Instructions and Transfer Instructions 


The various methods of addressing memory and peripherals are shown in table 2-2. 


Immediate addressing is an addressing mode specific to the immediate instruction group. 


Table 2-2. Addressing Modes 


Operand Formats 
0 0 | 
0 
1 
1 


Type of 
Addressing 


PC-relative -128* to +127 
Indexed 


Immediate 


-128* to +127 


-128* to +127 


Auto-indexed -~128* to +127 


*Note: For memory-reference instructions that are PC-relative, 
indexed, and auto-indexed, the contents of the Extension 
Register are substituted for the displacement if the value of 
the instruction displacement equals -128,, (801 ¢). 


2.3.2.1 PC-Relative Addressing 


A PC-relative address is formed by adding the displacement value specified in the operand field of the instruction 
to the current contents of the program counter. The displacement is an 8-bit twos-complement number, so the 
range of the PC-relative addressing format is -128,9 to +127,,9 bytes from the current location of the Program 
Counter. During execution of an instruction, the program counter contains the address of the last byte of the 
instruction. In the assembly language source statement, a symbolic expression representing an address normally 
is used in the operand field. In this case, the assembler generates the displacement from the current address to 
the address specified by the symbolic expression. The following examples show the use of PC-relative addressing. 
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Location Generated 


Counter Code 
0005 COOE LOOP: LD. TEMP sLOAD THE VALUE IN TEMPORARY STORAGE 
O000E 90F5 JMP LOOP sREPEAT 
0014 04 TEMP: BYTE X'04 


The assembler assumes PC-relative addressing in the memory-reference and transfer instructions when no 
pointer-register operand is specified. 
2.3.2.2 Immediate Addressing 


Immediate addressing uses the value in the second byte of a double-byte instruction as the operand for the opera- 
tion to be performed (see below). 


This byte is used as the 
instruction operand. 


byte 1 byte 2 


For example, compare a Load (LD) Instruction to a Load Immediate (LDI) Instruction. The Load Instruction uses 
the contents of the second byte of the instruction in computing the effective address of the data to be loaded. The 
Load Immediate Instruction uses the contents of the second byte as the data to be loaded. Because the operand 
occurs as the second byte of a two-byte instruction, page boundary conditions should be observed as mentioned 

in 2.3.1. 


2.3.2.3 Indexed Addressing 


Indexed addressing enables the programmer to address any location in memory through the use of the pointer 
register and the displacement. When indexed addressing is specified in an instruction, the contents of the 
designated pointer register are added to the displacement to form the effective address. The contents of the 
pointer register are not modified by indexed addressing. Indexed addressing is used to access tables or sub- 
routines, to transfer control to another page, or to transfer control to a section of the current page that is 
outside the range of the PC-relative transfer. The rules for page boundaries still apply, so the user is cau- 
tioned about crossing page boundaries when using indexed addressing to access tables. Such a reference results 
in a wrap-around from the end to the beginning of the page, or vice-versa (2.3.1). 


2.3.2.4 Auto-Indexed Addressing 


Auto-indexed addressing provides two capabilities: (1) the ability to reference (load, store, and so forth) a 
memory location specified by the contents of a designated pointer register, and (2) the ability to increment or 
decrement the contents of the designated pointer register by the value of the displacement. 


If the displacement is less than zero, the pointer register is decremented by the displacement before the contents 
of the effective address are fetched or stored. If the displacement is equal to or greater than zero, the pointer 
register is used as the effective address, and the pointer register is incremented by the displacement after the 
contents of the effective address are fetched or stored. 
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NOTE 


The contents of the pointer register are modified by 
auto-indexed addressing. 


An at sign (@) before the displacement operand designates an auto-indexed operation. Example: 


Generated 
Code 
C601 LD @1(P2) ;GET A BYTE FROM THE TABLE, AUTO-INDEX 
24 INPUT/OUTPUT FACILITIES 


SC/MP uses a single bidirectional input/output bus to interconnect the CPU, memory, and peripheral devices. 
Peripheral devices are assigned memory addresses, so standard memory-reference instructions can be used 
for input/output operations. 


Peripheral device addressing, data exchange, status reporting, and control-signal operations are performed by 
an external device controller. Because of variations in peripheral devices, depending on the function performed, 
a standard input/output operation cannot be described here. Similarly, the device controller operations vary 
widely, depending on the peripheral device being serviced. SC/MP provides the following facilities, which may 
be used in various applications, providing they match the device controller in use. Refer to figure 2-4. 

@ 16-bit Address 

e 8-bit Parallel Input/Output 

e 1-bit Serial Input 

® 1-bit Serial Output 

e 3 Flag Outputs 


@ 2 Sense Inputs 


2.4.1 Address Lines 


The 12-bit address lines contain the displacement portion of the effective memory address generated in response 
to a memory-reference instruction. The 4-bit page portion of the effective memory address is output on the 
data bus (see 2.4.4). Because peripheral devices are assigned memory addresses, a decoder in the associated 
device controller looks for its address or addresses. (Multiple addresses may be assigned to multifunction 
devices.) Details of interfacing hardware to SC/MP may be found in the SC/MP Data Sheet. 


2.4.2 Parallel Input/Output 


An 8-bit bidirectional data bus transfers data between the peripheral device controller and the processor. These 
data are associated with the memory-reference instruction that addressed the peripheral device. It is the function 
of the peripheral-device controller to place data on the line when the device is addressed for input and to transfer 
data from the lines when the device is addressed for output. The direction of the data transfer depends on the 
nature of the memory-reference instruction. 


2.4.3 Serial Input/Output 


Serial input/output is provided by using one of the eight data lines, or dedicated flag and sense input, or the 
Extension Register as a serial input/output shift register. 
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12 ADDRESS LINES 


8 DATA LINES PERIPHERAL 


CONTROLLER 


READ/WRITE TIMING 
AND CONTROL 


Figure 2-4. Interface to Peripheral Device Controller 


In systems that have only one serial input/output device, the serial input and output pins may be tied directly 
to the input/output device and no address decoding is necessary. The Serial Input/Output Instruction (SIO) then 
is used for serial input/output. Timing may be provided by program loops using the delay instruction or by 

an external timing element that is tested by the jump-condition inputs. For asynchronous systems, a flag may 
be pulsed each time a new bit is shifted in/out, and a sense condition tested to detect bit received/ready. 


Systems that have several serial input/output devices must be multiplexed, and device selection may be provided 
by the control flags, or by use of the parallel input/output commands to load an external latch. 


The serial-data input and output pins may be used as sense-input and flag-output lines in systems that do not 
require the serial input/output function. 


2.4.4 Input/Output Status 


The input/output status (figure 2-5) is output on the data bus, along with the appropriate timing information on 
the timing lines, so the peripheral controller has the additional information available if it is required by a par- 
ticular system. Two of the input/output status bits are for hardware functions (R-flag and I-flag); the remaining 
6 input/output status bits are generated under software control. 


7 0 
Let Po festiefafs 


A15 to Al2 — Four most significant (page) address bits 
H — H-flag generated by HALT instruction 
D — D-flag generated by DLY instruction 
I — J-flag generated by hardware for instruction fetch cycle 
R — R-flag generated by hardware for read input/output cycle 


Figure 2-5. Input/Output Status 
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2.5 INTERRUPT FACILITIES 


When the Internal Interrupt Enable Flag (IE) in the Status Register is set under program control, the Sense A 
line is enabled to serve as an interrupt request input; when the IE Flag is reset, SC/MP is inhibited from 
detecting interrupts. Thus, while the IE Flag is set, the Sense A input is tested before the fetch phase of 
each instruction as shown in figure 2-6. Upon detection of an interrupt request (Sense A high), the following 
events occur automatically. 


bs The IE Flag of the Status Register is reset to prevent SC/MP from responding to any further 
interrupt requests. Interrupt request capability then can be reenabled during or at the end 
of the ensuing user-generated interrupt service routine via the Enable Interrupt Instruction 
(IEN) or by copying the Accumulator into the Status Register. 


ae The contents of the Program Counter are exchanged with the contents of the Pointer Register 3. 


oF The contents of the Program Counter are incremented by one to address the first instruction of 
the user-generated interrupt service routine. 


In order to enable interrupts, the interrupt system must be armed. This is accomplished, first, by setting the 
interrupt enable bit in the Status Register to '1' (by executing an Enable Interrupt Instruction or a Copy Accu- 
mulator to Status Register Instruction) and, then, by fetching and executing one additional instruction. A return 
from interrupt, therefore, can be accomplished by the Enable Interrupt Instruction (IEN) followed by Exchange 
Pointer 3 and Program Counter Instruction (XPPC 3). Interrupts are disarmed by setting the interrupt enable 
bit in the Status Register to '0' (by executing a Disable Interrupt Instruction (DINT) or a Copy Accumulator to 
Status Register Instruction (CAS)). 


INITIALIZE 


INSTRUC TION NO ® 
FETCH TIME 
YES 
INTERRUPT NO 


SYSTEM ARMED 


CONTINUE NO 


INPUT HIGH 


RESET INTERRUPT ENABLE 
EXECUTE XPPC 3 


INCREMENT PC 


FETCH INSTRUCTION 
EXECUTE INSTRUC TION 


Figure 2-6. SC/MP Interrupt/Instruction-Fetch Process 
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Chapter 3 


ASSEMBLY LANGUAGE 


SC/MP assembly language statements have well-defined formats constructed from the elements described in 
this chapter. 


3.1 BASIC ELEMENTS 


3.1.1 Character Set 


Statements are written using the following letters, numbers, and special characters: 


Letters: A through Z 
Numbers: 0 through 9 
Special Characters: 1S$UESa'()¥*¥+,-./:3< => @bHA 


Note: 6 means blank 


Except for the lower-case letters, any of the printable characters listed in appendix A, table A-1, ASCII Character 
Set in Hexadecimal Representation, may be specified with a . ASCII directive (see 4.5.9). 


Example: 

MSG3: .ASCII ‘ORDER # 326-001' 
Nonprintable (or printable) characters may be specified with a . BYTE directive (see 4. De 9) or a .DBYTE directive 
(see 4.5.6). 


Examples: 


CR: -_BYTE OD s;CARRIAGE RETURN 
CRLF: .DBYTE ODOA s;CARRIAGE RETURN/LINE FEED 


3.1.2 Data Representation 


Data are represented internally in SC/MP in twos-complement integer notation and binary-coded-decimal (BCD) 
notation. In twos-complement notation, the negative of a number is formed by complementing each bit in the 
data word and adding one to the complemented number. The sign of the number is indicated by the most signifi- 
cant bit. When the most significant bit is a '0', the number is positive or zero; when the most significant bit is 
a'l', the number is negative. Maximum range for a 16-bit number in this system is 7F FF yg (+327671 ) to 
80001, (-32768 19). Maximum range for an 8-bit number is 7F yg (+1271) to 807¢ (-128 9). 


BCD notation is a system of number representation in which the decimal digits 0 through 9 are represented by 
a group of four binary digits. For example: 


7 0 


2549 = |9 0 1 OF0 1 0 1 


The maximum range of BCD values is 0 to 99;9. To obtain a BCD constant, the user may code one or two digits 
(0 through 9) as a hexadecimal constant, for example, 059. 
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a ees | Terms 


The relationship of terms is shown in figure 3-1. The various types of terms are described in the following 
paragraphs. 


Terms 
reste arcs rome 
Self- defining (literal) Symbols 
Numbers Strings Labels Nonlabels 
pomresinnen 
Decimal Digits | Hexadecimal Alpha Numbers _ Special 


. | Characters 


X' Digits 0 Digits 
Figure 3-1. Relationship of Terms 


3.1.3.1  Self-Defining Terms 


A self-defining term, or constant, has its value inherent in the term. The assembler program does not assign 
a value to the term but does derive the value from the term. 


Self-defining terms are used to specify immediate data, addresses, registers, and input/output information to 


the assembler program. Three types of self-defining terms are available: decimal, hexadecimal, and character 
(or string). 


A decimal self-defining term is zero, or a decimal integer that does not begin with zero. For 16-bit data, the 
value range is 0 to 65,535 for an unsigned decimal integer and -32, 768 to +32,767 for a signed decimal integer. 
For 8-bit data, the value range is 0 to 255 for an unsigned decimal integer and -128 to +127 for a signed decimal 
integer. It should be noted that having signed and unsigned data is just a coding convenience made available be- 
cause some instructions treat data as signed values and others treat data as unsigned values. For example, in 
8-bit data, a signed number such as -1j9 or an unsigned number such as 255j9 is converted to FFj¢ by the 
assembler. The microprocessor performs signed arithmetic except when executing decimal-add instructions. 


Examples: 


decimal constants 


. BYTE 200, -100, 0, +32 
.DBYTE 0, 40000, -3165 
LDI 0 

XRI 20 


A hexadecimal self-defining term may be specified in either of two ways. The term may start with X', or the 


term may start with a leading zero. The range of hexadecimal numbers is 0 to FFFFyg¢ for 16-bit data and 
0 to FFyg¢ for 8-bit data. 


Examples: 


hexadecimal constants 


. BYTE X'FF, X'10 

. DBY TE X'1FE, X'FFFF 
XRI 015 

LDI X'40 
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A character self-defining term is defined as a string. A string is a series of characters or a single character 
enclosed in single quote marks (for example, 'THIS IS A STRING'). All letters, numbers, and special charac- 
ters (including blanks) may be specified in a string. If a single quote mark is part of the character string, it 
should immediately be preceded by another single quote mark; for example, 'DON''T DO IT" represents DON'T 
DO IT. A null string ('') causes the assembler to generate a single blank. String characters are translated to 
ASCII code (see appendix A) in memory with each character occupying 8 bits. Refer to the . ASCII directive 
described in 4.5.9. 


Examples: 
ASCII constants 
Go 8 
. ASCII "NUMBER='! 
XRI ry? 
LDI a 


3.1.3.2 Symbolic Terms 


Symbols are the most common means of referencing address locations or arbitrary values. Symbols are defined 
(assigned values) by one of three methods: 
1. By appearing in a label field in a statement (see 3.2.1). 
symbol 
SUBL: LDI 0 ;C LEAR AC 


The value assigned to a symbol appearing in the label field is the address of the instruction, 
data, or storage location named by the symbol. 


2. By using an assignment statement to assign a specific value to a symbol (see 4.4). 
symbol 
co 
p2 = 2 3sTACK POINTER 


sn By using a .FORM directive statement to assign a value to a symbol (see 4.5.12). 
symbol 
cf’ 
. FORM DATA, 2,2,4(X'A) 


NOTE 
The . FORM directive is not available in all 
assemblers. 


Symbol construction must meet the following restrictions: 


1. A symbol may contain one or more alphanumeric characters, the first of which must be either 
a letter or a dollar sign ($). 


2s Although up to 32 characters may be included, only the first six characters are recognized by 
the assembler program. Therefore, the programmer must ensure that a long symbol is unique 
in the first six characters. 


Example: LONGSY 


LONGSYMBOLI1 are identical to the assembler 
LONGSY MBOL2 
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3. If the first character in the symbol is a dollar sign ($), the symbol is defined as a local symbol. 
The . LOCAL operator allows the programmer to specify that local symbols appearing between 
two . LOCAL directive statements have a certain meaning only within that region of the program 
(see 4.5.10, . LOCAL Directive). This enables the programmer to use common mnemonics 
throughout a program without causing a conflict of names. 


NOTE 


Within a local region, a long local symbol must be 
unique in the first five characters, including the 
dollar sign ($). 


Example: $ABCD 


$A BCDEF } are identical symbols to the assembler. 


4. No special characters or embedded blanks may appear within a symbol. 


D« Symbol values cannot exceed 65, 535 for unsigned 16-bit data, -32,768 to +32, 767 for signed 
16-bit data, 255 for unsigned 8-bit data or -128 to +127 for signed 8-bit data. 


Several examples of symbols follow: 


Legal Symbols Illegal Symbols Reason Illegal 

$ABC LONGSYMBOLI1 First six ch t t uni 
LONGSYMBOL LONGSYMBOL2 irst six characters are not unique 

$A B2 2AB First character must be a letter or a 

$2 #CDE dollar sign 

XYZ XYZ$ Last character is not alphanumeric 

$A BCDEF $A BCDE First five characters of the local symbols 
$A BC2ZEF Sancne | are not unique. 


A symbolic term may represent a memory address and, hence, may have a value ranging between 0 and 65,5351. 
Since SC/MP is an 8-bit machine, such a value requires two 8-bit bytes for its containment. In order to 
facilitate working with such values, they have been divided by the assembler into two halves, designated the 
"high" and the "low" parts of the value. The high part represents the upper half of the value (bits 15-8) and 

the low part represents the lower half (bits 7-0). These may be referred to in assembly language by using the 
forms, H(SYMBOL) and L(SYMBOL). For example: 


If SYMBOL = X'FOD9, 
then H(SYMBOL) = X'FO, 
L(SYMBOL) = X'D9, 
H(SYMBOL) + 1 = X'F1, 
and L(SYMBOL) + 2 = X'DB. 


Or if OTHER = SYMBOL + 3, 
then OTHER = X'FODC, 
H(OTHER) = X'FO, 
and L(OTHER) = X'DC. 


The forms, H(SYMBOL) and L(SYMBOL), may be used in any context where an 8-bit value would be appropriate. 
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3.1.4 Expressions 


Operand entries (see 3.2.3), consisting of either a single term or an arithmetic or a logical combination of 
terms, are called expressions. Expressions are either simple or multiterm. Simple expressions are single 
terms, such as a symbol or a self-defining term. Multiterm expressions are simple expressions combined 
using the arithmetic and logical operators shown in table 3-1. The multiterm expression is evaluated by the 
assembler program in a left-to-right order regardless of the operators used between the terms. Parentheses 
are not permitted for the purpose of grouping arithmetic and/or logical operations; they have special signifi- 
cance in defining certain assembler functions. 


Examples: L(TABLE) + X'10 
100 - 1 
ENTRY1 + ENTRY2 - 4 
A >B * DISKAD 


The result of the evaluated expression is a 16-bit value; however, the magnitude of the expression must be 
compatible with the storage allocated for the expression. For example, if the expression is to be stored in 


8 bits, then the value of the expression must not exceed FFi¢- 


Example: Expression value must not 
LDI X'40 + CHAR exceed FF ¢. 


If the expression is used to indicate a register, then the value must not exceed 3. 


Example: Expression value must not 
AND 0 (PTR + N) — exceed 3. 


Table 3-1 lists the arithmetic and logical operators available for forming expressions. 
A unary operator operates upon one operand and appears in the format 'operator operand' (for example, -9). 
A binary operator operates upon two operands and appears in the format 'operand1 operator operand2' (for 


example, A&B). 


The expressions ''A < B", ''A = B", and "A > B" cause the specified comparison to be made. The result is one 
if the condition is true or zero if the condition is false. 


Table 3-1. Arithmetic and Logical Operators 


Addition 


Binary 


Subtraction Unary or binary 


Binary 


Multiplication 


Division Binary 


Logical NOT Unary 


Logical AND Binary 


Logical OR 


Binary 


"Less Than" 


Binary 


"Equal To" Binary 


"Greater Than" Binary 


3.2 ASSEMBLER CODING CONVENTIONS 


Assembly language programs consist of source statements, each of which occupies one line of text. There are 
five types of source statements accepted by the assembler: the instruction, the comment, the pseudo instruction, 
the assignment, and the directive. Except for comment statements, each type of source statement contains from 
one to five fields in the following order. 


[label field] operation field [operand field] [ comment field] [identification field] 


A sample coding form with the five fields delineated is shown in figure 3-2. Since the assembler accepts free-form 
statements, the user may disregard field boundaries. However, for clarity and readability, the use of field bound- 
aries is highly recommended. 


3.2.1 Label Field 


The label field is optional and may contain a symbol used to identify the current statement when referenced in 
other statements. More than one label may appear in the label field, in which case any of the labels may be 
used to reference the labeled location. A label may appear by itself in a statement, in which case it refers to 
the next instruction or data word in the source program. 


Example: LABEL1: 
LABEL2: 
LABEL38: LABEL4: LDI 1 


3.3.2 Operation Field 


The operation field is mandatory and contains a mnemonic operation code (opcode) that defines an assembler (such 
as a directive) or a machine operation (such as a load). A blank terminates the operation field. 


Operation mnemonics are used in directive and instruction statements. Instruction statements define the machine 
operations necessary to perform the desired function. Valid operation mnemonics for instruction statements are 
listed in appendix B. Directive statements control the process of program assembly and may generate data. Valid 
directive mnemonics are listed in appendix D. 


3.2.3 Operand Field 


The operand field contains entries that identify data to be acted upon by the statement. A space is not required 
to terminate the field. An operand entry is composed of one or more terms which represent a value. The value 
may be inherent in the term, in which case the term is self-defining (3.1.3.1); or the value may be assigned by 
the assembler program during assembly, in which case the term is symbolic (3.1.3.2). An arithmetic combina- 
tion of terms is reduced to a single value by the assembler program as described in 3.1.4. The relationship of 
terms is shown in figure 3-1. 


3.2.4 Comment Field 


Comments are optional descriptive notes printed on the program listing for programmer reference. Comments 
should be included throughout the program to explain subroutine linkages, assumptions made, formats of inputs 
processed, and so forth. A comment may follow a statement on the same line, or the comment may be entered 
on one or more separate statement lines. The comment has no affect on the assembled program, but it is 
printed on the program listing. 
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The following conventions apply to comments: 


1. A comment must be preceded by a semicolon (5). 
2. All valid characters, including blanks, may be used in comments. 
3. Comments should not extend beyond column 72, but a comment may be carried over on the 


following line (preceded by a semicolon). 


3.2.5 Identification Sequence Field 
The identification sequence field is an optional entry that specifies program identification and/or statement 
sequence characters. If the field or a portion of the field is used for program identification, the identification 


is punched in the statement cards and is printed on the program listing. This field generally is not used with 
paper tape input. 


As an aid to keeping source statements in order, the programmer may code a sequence of characters in ascend- 
ing order in the identification sequence field. 


The identification sequence field is fixed in columns 73 through 80 of the source image. Columns 73 through 80 
are ignored by the assembler but are printed in the program listing. 


In some cases, the width of the carriage of the printer is not wide enough to include the identification sequence 
field in the program listing. 
3.2.6 Example of Statement 


An example of an assembler statement follows: 


Label Operation Operand Comment 
GETVAL: LD 1(P2) ;sGET A VALUE 


The label, GETVAL, is a symbolic name for the address of this instruction. Thus, GETVAL canbe used in 
other statements (preceeding or following) to address this statement. The mnemonic operation code, LD, 
stipulates the type of operation. The operand field specifies a pointer, P2, and a displacement, +1; and the 
comment field contains a note that may be used by the programmer to identify quickly the action defined by 
the statement. See chapter 5 for other statement examples. 
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Chapter 4 


STATEMENTS 


The SC/MP assembler accepts five types of statements: instruction, comment, pseudo instruction, assignment, 
and directive. One of these basic statements or a combination of them may be used to create macros. The 
individual statement types are described in this chapter. The definition and the use of macros is described in 
chapter 6. 


4.1 INSTRUCTION STATEMENTS 


The assembly language instruction set of the SC/ MP provides arithmetic, logic, shift, transfer, and other 
operations between the accumulator and memory or the other registers. 


Instruction statements, when assembled, generate the object (machine) code that defines the operations the 
processor will perform. Depending on the instruction type, one or two bytes of object code are generated for 
each instruction assembled. 


In the following descriptions, any user accessible register or bit that is not explicitly mentioned will not be 
altered by the instruction. 


There are 46 SC/ MP instruction statements that comprise the following eight classes: 


e Memory Reference 

e Memory Increment/Decrement 

e Immediate 

e Transfer 

e Extension Register 

e Pointer Register Move 

e Shift, Rotate, and Serial Input/Output 

e Miscellaneous 
Refer to table 4-1 for definitions of the symbols used in the notation for describing the SC/ MP instruction set. 
Upper-case mnemonics refer to units designated by fields of the instruction words; lower-case mnemonics refer 
to the numerical values of the corresponding fields. For example, ptr in an assembler statement denotes the 
number of a pointer register, whereas (AC) ~— (PTR) denotes the contents of the accumulator are replaced by 
the contents of a pointer register. In the case where both a lower-case mnemonic and an upper-case mnemonic 


are composed of the same letters, only the lower-case mnemonic is given in table 4-1. Lower-case notation 
designates a variable. 


The SC /MP instruction set is summarized in table 4-2. 


Alternate opcodes are given for some instructions. The alternates listed are consistent with those used for other 
microprocessors manufactured by National Semiconductor. 


Table 4-1. Symbols and Notation 


Symbol and ; 

Notation Meaning 

AC 8-bit Accumulator. 

address In the operand field of memory-reference, memory increment/decrement or 


transfer instruction source statements, address indicates the symbolic 
expression that represents a memory location. The assembler calculates 
the displacement (disp) for the instruction from address and generates the 
instruction with PC-relative addressing. 


Carry/Link Flag in the Status Register. 


8-bit immediate data field. Data may representa signed or an unsigned 
twos complement number or a binary coded decimal (BCD) number. 


Displacement represents a signed 8-bit address modifier in a memory- 
reference, memory increment/decrement or transfer instruction. 


Effective Address as specified by the instruction. 


Extension Register; provides for temporary storage, variable displacements 
and separate serial input/output port. 


Represents the bit in one of the bit positions, 7 through 1, of the Accumulator 
or the Extension Register. 


Interrupt Enable Flag. 


Mode bit, used in memory reference instructions. Blank parameter sets 
m=0, @ sets m= 1. 


Overflow Flag in the Status Register. 


Program Counter (Pointer Register 0); during address formation, PC 
points to the last byte of the instruction being executed. 


Pointer Register (ptr = 0 through 3). The register specified in byte 1 of 
the instruction. 


Pointer register bits; n:m = 7 through 0 or 15 through 8. 

Serial Input pin. 

Serial Output pin. 

8-bit Status Register. 

Means "contents of.'' For example, (EA) is contents of Effective Address. 
Means optional field in the assembler instruction format. 

Ones complement of value immediately to right of ~. 

"Replaces". 

"Is replaced by". 

"Exchange". 


When used in the operand field of the instruction, sets the mode bit (m) to 
1 for auto-incrementing/auto-decrementing indexing. 


Modulo 10 addition. 

AND operation. 
Inclusive-OR operation. 
Exclusive-OR operation. 
Greater than or equal to. 
Equals. 


Does not equal. 
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4. 


1. 
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Memory Reference Instructions 


This group of eight instructions provides logic, arithmetic, and data-transfer operations between the accumulator 
and the effective address. The Memory Reference Instructions and mnemonics are as follows: 


Load . . . ee LD 

Store . 2. 0. 6 eee kk ST 
AND... . eee ee) CAND 

OR. . 2. 1. we ee ee e”:”:CSOSRRR 
Exclusive-OR . . . . . . 0) we XOR 
Decimal Add. . . . . .hOeetestiC‘“YtStst~<(eS*i‘é~éACW*”;SYYS~XDECCAA 
Add... ns 6D) D) 
Complement and ‘Add rn OF. BD) 


The Effective Address (EA) may be PC-relative, indexed, or auto-indexed as shown in table 4-3. 


° Table 4-3. Memory Reference Formats 


Operand Formats 


ee _[ eens 
Cre 
ce ed 
es ee ede 


*Note: The contents of the Extension Register are substituted for 
the displacement if the displacement equals -128), (806). 


Addressing 


PC-relative addressing is assumed when only a symbolic name of an address is specified (example: LD VALUE). 
Indexed addressing requires a displacement and one of the four pointer registers (example: ADD 10(P1)). Auto- 
indexing requires the "at sign, '' a displacement, and a pointer register (other than PC) (example: ST @-1(3)). 


The source statement format, the instruction format, and the description of the operation of each Memory Refer- 
ence Instruction follow. 


LOAD (LD) 


Mnemonic Op erands 


SOURCE STATEMENT INSTRUCTION FORMAT 


address 
disp(ptr) 
@disp(ptr) 


Operation: (AC) —— (EA) 


The contents of the Effective Address, (EA), replace the contents of the Accumulator, (AC). The 
initial contents of AC are lost; the contents of EA are not altered. 


STORE (ST) 
SOURCE STATEMENT INSTRUCTION FORMAT 


Mnemonic Operands 


address 
ST disp(ptr) 
@disp(ptr) 


Operation: (EA) ~«- (AC) 
The contents of the Accumulator, (AC), replace the contents of the Effective Address, (EA). The 
initial contents of EA are lost; the contents of AC are not altered. 
AND (AND) 
SOURCE STATEMENT INSTRUCTION FORMAT 


Mnemonic Oper ands 


address 
AND disp(ptr) 
@disp(ptr) 


Operation: (AC) ~— (AC) A (EA) 


The contents of the Accumulator, (AC), are ANDed with the contents of the Effective Address, (EA), 
and the result is stored in AC. The initial contents of AC are lost; the contents of EA are not altered. 
The truth table for this instruction is shown below. 


b = bits 7 to 0 
OR (OR) 


SOURCE STATEMENT INSTRUCTION FORMAT 


Mnemonic Operands 


address 
OR disp(ptr) 
@disp(ptr) 


Operation: (AC) —— (AC) v (EA) 


The contents of the Accumulator, (AC), are inclusive-ORed with the contents of the Effective Address, 
(EA), and the result is stored in AC. The initial contents of AC are lost; the contents of EA are not 
altered. The truth table for this instruction is shown below. 


b = bits 7 to 0 
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EXC LUSIVE-OR (XOR) 
SOURCE STATEMENT INSTRUCTION FORMAT 


Mnemonic Operands 


address 
XOR disp(ptr) 
@disp(ptr) 


Operation: (AC) ~— (AC) 7 (EA) 


The contents of the Accumulator, (AC), are exclusive-ORed with the contents of the Effective Address, 
(EA), and the result is stored in AC. The initial contents of AC are lost; the contents of EA are not 
altered. The truth table for this instruction is shown below. 


b = bits 7 to 0 


DECIMAL ADD (DAD, DECA) 


SOURCE STATEMENT INSTRUCTION FORMAT 
Mnemonic Operands 
DAD address m 
DECA disp(ptr) 
@disp(ptr) byte 1 


Operation: (AC) —- (AC)49 + (EA)y9 + CY/L; CY/L 


The contents of the Accumulator, (AC), and the contents of the Effective Address, (EA), are treated 
as 2-digit binary-coded-decimal (BCD) numbers. The contents of AC, the contents of EA, and the 
Carry Flag, CY/L, are added, and the 2-digit BCD sum is stored in AC. The initial contents of AC 
are lost; the contents of EA are not altered. The Carry Flag is set if a carry occurs from the most 
significant decimal digit; otherwise, it is cleared. The Overflow Flag is not affected. 


Example of a 2-digit BCD number: 


0 01 31;0 10 1 


(AC) or (EA) 


NOTE 


The range of a 2-digit BCD number is 0 through 9919 
(0 <BCD < 99). 


ADD (ADD) 
SOURCE STATEMENT INSTRUCTION FORMAT 


Mnemonic Oper ands 


address 
ADD disp(ptr) 
@disp(ptr) 


Operation: (AC) = (AC) + (EA) + CY/L ; CY/L, OV 


The contents of the Accumulator, (AC), and the contents of the Effective Address, (EA), are treated 
as 8-bit binary twos complement numbers. The contents of AC, the contents of EA, and the Carry 
Flag, CY/L, are added, and the sum is stored in AC. The initial contents of AC are lost; the contents 
of EA are not altered. The Carry Flag is set if a carry from the most significant bit position occurs; 
otherwise, it is cleared. The Overflow Flag, OV, is set if the sign of the result differs from the sign 
of both operands; otherwise, it is cleared. 


COMPLEMENT AND ADD (CAD) 


SOURCE STATEMENT INSTRUCTION FORMAT 


7 3{2{/1,0 


Mnemonic Operands 


t t t t t 
address 111411 
CAD disp(ptr) 
@disp(ptr) byte 1 


Operation: (AC) — (AC) + ~ (EA) + CY/L; CY/L, OV 


The contents of the Accumulator, (AC), and the contents of the Effective Address, (EA), are treated as 
8-bit binary, twos complement numbers. The contents of AC, the ones complement of the contents of 

EA, and the Carry Flag, CY/L, are added, and the sum is stored in AC. The initial contents of AC are 
lost; the contents of EA are not altered. The Carry Flag is set if a carry from the most significant bit 
position occurs; otherwise, it is cleared. The Overflow Flag, OV, is set if the sign of the result is the 
same as the sign of the contents of EA and opposite the sign of the contents of AC; otherwise OV is cleared. 


NOTE 


If the Carry Flag is cleared initially, the ones 
complement of the contents of E is added to the 
contents of AC. If the Carry Flag is set, the 
twos complement of the contents of E is added 
to the contents of AC. 


4.1.2 Memory Increment/Decrement Instructions 


The two double-byte instructions in this group may be used to maintain a software counter in memory. The 
Memory Increment/Decrement Instructions and mnemonics are as follows: 


Increment and Load. . . . . . . . 2. «2. «© ILD 
Decrement and Load . .. . . . «.« «2 «© «© + DLD 


The source statement format, the instruction format, and the description of each Memory Increment/Decrement 
Instruction follow. 


NOTE 


At the hardware level, these instructions access the 
memory in a read-alter-write mode. The processor 
retains control of the input/output bus between the 
data read and write operations. 


INCREMENT AND LOAD (ILD) 
SOURCE STATEMENT INSTRUCTION FORMAT 


Mnemonic Oper ands 


address 


ae disp(ptr) 


Operation: (AC), (EA) —- (EA) + 1 


The contents of the Effective Address, (EA), are incremented by 1, and the result is stored in the 
Accumulator, AC, and, also, in EA. The initial contents of AC and EA are lost. 


DECREMENT AND LOAD (DLD) 


SOURCE STATEMENT INSTRUCTION FORMAT 
Mnemonic Operands Us ee ee ,2;1,0 
DLD AOCECSS 1031i%t1éiii1é+(0 
disp(ptr) 


byte 1 
Operation: (AC), (EA) — (EA) - 1 
The contents of the Effective Address, (EA), are decremented by 1, and the result is stored in the 
Accumulator, AC, and, also, in EA. The initial contents of AC and EA are lost. 
41.3 Immediate Instructions 
The immediate instructions perform most of the same operations as the memory-reference instructions. The 


data used in the operations comes from the byte immediately after the opcode byte; that is, the data byte is the 
displacement. The Immediate Instructions and mnemonics are as follows: 


Load Immediate. . . . . 2. © © «© «© «© «© + LDI, LI 
AND Immediate. . . . . . . . «. . « «© «. ANI 
OR: Immediate 2. «© ~ ££ & © & % w@ we « ORI 
Exclusive-OR Immediate . . . . . . . . .«. - XRI 
Decimal Add Immediate . . . . . . . . . . DAI 
Add Immediate . . . . . . . . « « «© « . ADI 
Complement and Add Immediate . . ..... . CAI 


The source statement format, the instruction format, and the description of each Immediate Instruction follow. 


LOAD IMMEDIATE (LDI, LI) 
SOURCE STATEMENT INSTRUCTION FORMAT 


Mnemonic Operand 


LDI 


dat 
LI ata 


Operation: (AC) —— data 


The data byte replaces the contents of the Accumulator, (AC). The initial contents of AC are lost; the 
data byte is not altered. 


AND IMMEDIATE (ANI) 


SOURCE STATEMENT INSTRUCTION FORMAT 


Mnemonic Operand 
ANI data 


Operation: (AC) ~—- (AC) A data 


The contents of the Accumulator, (AC), are ANDed with the data byte, and the result is stored in AC. 
The initial contents of AC are lost; the data byte is not altered. The truth table for this instruction is 
shown below. 


b = bits 7 to 0 


OR IMMEDIATE (ORI) 
SOURCE STATEMENT INSTRUCTION FORMAT 


Mnemonic Operand 
ORI data 


Operation: (AC) —- (AC) v data 


The contents of the Accumulator, (AC), are inclusive-ORed with the data byte, and the result is stored 
in AC. The initial contents of AC are lost; the data byte is not altered. The truth table for this instruc- 
tion is shown below. 


b = bits 7 to 0 
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EXC LUSIVE-OR IMMEDIATE (XRI) 


SOURCE STATEMENT INSTRUCTION FORMAT 


(re er 
11100100 


byte 1 byte 2 


Mnemonic Operand 
XRI data 


Operation: (AC) —- (AC) 7 data 


The contents of the Accumulator, (AC), are exclusive-ORed with the data byte, and the result is stored 
in AC. The initial contents of AC are lost; the data byte is not altered. The truth table for this instruc- 


tion is shown below. 


b = bits 7 to 0 


DECIMAL ADD IMMEDIATE (DAI) 


SOURCE STATEMENT INSTRUCTION FORMAT 


(yy yp yy 9 
11101100 


byte 1 byte 2 


Mnemonic Operand 


DAI data 


Operation: (AC) — (AC)j9 + datayg + CY/L; CY/L 


The contents of jhe Accumulator, (AC), and the data byte are treated as 2-digit binary-coded-decimal 
(BCD) numbers. The contents of AC, the data byte, and the Carry, CY/L, are added, and the 2-digit 
BCD sum is stored in AC. The initial contents of AC are lost; the data byte is not altered. The Carry 
Flag is set if a carry from the most significant decimal digit occurs; otherwise, it is cleared. The 
Overflow Flag is not affected. 


NOTE 


To code a BCD number in the data field of the source 
statement, the user must enter it as a hexadecimal 
value. Example: 058 or X'58 to represent BCD 58. 
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ADD IMMEDIATE (ADI) 


SOURCE STATEMENT INSTRUCTION FORMAT 


Mnemonic Operand 
ADI data 


byte 1 
Operation: (AC) ~- (AC) + data + CY/L; CY/L, OV 
The contents of the Accumulator, (AC), and the data byte are treated as 8-bit binary, twos complement 
numbers. The contents of AC, the data byte, and the Carry Flag, CY/L, are added, and the sum is stored 
in AC. The initial contents of AC are lost; the data byte is not altered. The Carry Flag is set if a carry 


from the most significant bit position occurs; otherwise, it is cleared. The Overflow Flag, OV, is set 
if the sign of the result differs from the sign of both operands; otherwise, it is cleared. 


COMPLEMENT AND ADD IMMEDIATE (CAI) 


SOURCE STATEMENT INSTRUCTION FORMAT 


Mnemonic Operand 
CAI data 


byte 1 


Operation: (AC) = (AC) + ~ data + CY/L; CY/L, OV 


The contents of the Accumulator, (AC), and the data byte are treated as 8-bit binary, twos complement 
numbers. The contents of AC, the ones complement of the data byte, and the Carry Flag, CY/L, are 
added, and the result is stored in AC. The initial contents of AC are lost; the data byte is not altered. 
The Carry Flag is set if a carry from the most significant bit position occurs; otherwise, it is cleared. 
The Overflow Flag, OV, is set if the sign of the result is the same as the sign of the data byte and 
opposite the sign of the contents of AC; otherwise, it is cleared. 


NOTE 


If the Carry Flag is set initially, this operation is 
equivalent tc subtracting the data byte from the 
contents of AC. 


4.1.4 Transfer Instructions 


The four double-byte instructions in this group are used for conditional and unconditional jumps within a routine, 
and jumps to subroutines. The Transfer Instructions and mnemonics are as follows: 


Jump . 2. 2. 6 ee JMP 
Jump if Positive. . . . . . . 6. 0h. ek JP 
Jump if Zero. . . . . 2... eee IZ 
Jump if Not Zero . . . . . . hehe INZ 


The effective address of a jump that is PC-relative is the PC plus the displacement (disp). The range of a PC- 
relative jump is -126 to +129 bytes from the jump instruction. As with the memory-reference instructions, the 
effective address does not affect the 4 most significant address bits; thus, wrap-around can occur at 4K page 
boundaries. When 'ptr' specifies a pointer register other than 0, the 4 most significant bits of the PC are 
replaced by the 4 most significant bits of the specified pointer. 


When assembling Transfer Instructions, the assembler reduces the specified displacement by one (1), so if the 
jump is taken the next instruction executed is located at the label specified in the jump instruction; that is, the 
effective address specified by the user. 


Example: 


Location Object 


Counter Code 
1000 9012 START: J MP LABEL sJUMP TO LABEL 
1014 LABEL: 

PC (during execution) 1001 

displacement 12 

EA 1013 


The source statement format, the instruction format, and the description of the operation of each Transfer — 
Instruction follow. 


JUMP (JMP) 


SOURCE STATEMENT INSTRUCTION FORMAT 


Mnemonic Operands 7, ont ,2 1,0 
address 10010 0 
JMP . | disp(ptr) 


Operation: (PC) < EA 


The Effective Address, EA, replaces the contents of the Program Counter, (PC). The next instruction 
is fetched from the location designated by the new contents of PC + 1. 


JUMP IF POSITIVE (JP) 
SOURCE STATEMENT INSTRUCTION FORMAT 


Mnemonic Operands 


address 


JP disp(ptr) 


Operation: If (AC) > 0, (PC) «+ EA 
If the contents of the Accumulator, (AC), are positive or zero, the Effective Address, EA, replaces the 


contents of the Program Counter, (PC). The next instruction is fetched from the location designated by 
the new contents of PC + 1. 
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JUMP IF ZERO (JZ) 


SOURCE STATEMENT INSTRUCTION FORMAT 


Mnemonic Oper ands 


address 


JZ disp(ptr) 


Operation: If (AC) = 0, (PC) « EA 


If the contents of the Accumulator, (AC), are zero, the Effective Address, EA, replaces the contents of 
the Program Counter, (PC). The next instruction is fetched from the location designated by the new 
contents of the PC + 1. 


JUMP IF NOT ZERO (JNZ) 


SOURCE STATEMENT INSTRUCTION FORMAT 


Mnemonic Operands Ty yd dl 2 41, 0 
1 1 
INZ 1 address 0 0 1 il 
disp(ptr) 


byte 1 
Operation: If (AC) #0, (PC) EA 


If the contents of the Accumulator, (AC), are not zero, the Effective Address, EA, replaces the contents 
of the Program Counter, (PC). The next instruction is fetched from the location designated by the new 
contents of the PC + 1. 


4.1.5 Extension Register Instructions 


This group of eight single-byte instructions is used for arithmetic and logic operations between the Extension 
Register (E) and the Accumulator (AC). The Extension Register Instructions and mnemonics are as follows: 


Load AC from Extension . . . . . . . . . . LDE 
Exchange AC and Extension . . . . .... . XAE 
AND AC with Extension a ANE 
OR AC with Extension . . . . . . . . heh ORE 
Exclusive-OR AC with Extension. . . . . .. . XRE 
Decimal Add AC and Extension . . . . . . . . DAE 
Add AC and Extension. . . . . .. . .. . ADE 
Complement and Add ExtensiontoAC . . . .. . CAE 


The source statement format, the instruction format, and the description of the operation of each Extension 
Register Instruction follow. 
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LOAD AC FROM EXTENSION (LDE) 


SOURCE STATEMENT INSTRUCTION FORMAT 


Mnemonic 


LDE 


Operation: (AC) — (E) 


The contents of the Extension Register, (E), replace the contents of the Accumulator, (AC). The 


initial contents of AC are lost; the contents of E are not altered. 


EXCHANGE AC AND EXTENSION (XAE) 


SOURCE STATEMENT INSTRUCTION FORMAT 


Mnemonic 


XAE 


Operation: (AC) <= (E) 


The contents of the Accumulator, (AC), are exchanged with the contents of the Extension Register, (E). 


AND AC WITH EXTENSION (ANE) 


SOURCE STATEMENT INSTRUCTION FORMAT 


Mnemonic 


ANE 


Operation: (AC) —- (AC) A (E) 


The contents of the Accumulator, (AC), are ANDed with the contents of the Extension Register, (E), and 
the result is stored in AC. The initial contents of AC are lost; the contents of E are not altered. The 


truth table for this instruction is shown below. 


b = bits 7 to 0 


OR AC WITH EXTENSION (ORE) 


SOURCE STATEMENT INSTRUCTION FORMAT 


Mnemonic 


ORE 


Operation: (AC) —- (AC) V (E) 


The contents of the Accumulator, (AC), are inclusive-ORed with the contents of the Extension Register, 
(E), and the result is stored in AC. The initial contents of AC are lost; the contents of E are not altered. 
The truth table for this instruction is shown below. 


b = bits 7 to 0 


EXC LUSIVE-OR AC WITH EXTENSION (XRE) 


SOURCE STATEMENT INSTRUCTION FORMAT 


Mnemonic 


XRE 


Operation: (AC) —— (AC) V (E) 


The contents of the Accumulator, (AC), are exclusive-ORed with the contents of the Extension Register, 
(E), and the result is stored in AC. The initial contents of AC are lost; the contents of E are not altered. 
The truth table for this instruction is shown below. 


b = bits 7 to 0 
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DECIMAL ADD AC AND EXTENSION (DAE) 
SOURCE STATEMENT INSTRUCTION FORMAT 
Mnemonic 


DAE 011010 0 0 


Operation: (AC) — (AC)j9 + (Eg + CY/L; CY/L 


The contents of the Accumulator, (AC), and the contents of the Extension Register, (E), are treated as 
2-digit binary-coded-decimal (BCD) numbers. The contents of AC, the contents of E, and the Carry 
Flag, CY/L, are added, and the sum is stored in AC. The initial contents of AC are lost; the contents 
of E are not altered. The Carry Flag is set if a carry from the most significant decimal digit occurs; 
otherwise, it is cleared. The Overflow Flag is not affected. 


ADD AC AND EXTENSION (ADE) 


SOURCE STATEMENT INSTRUCTION FORMAT 


Mnemonic 7, oy tt tl ty 9 
ADE 014131000 0 


Operation: (AC) — (AC) + (E) + CY/L; CY/L, OV 


The contents of the Accumulator, (AC), and the contents of the Extension Register, (E), are treated as 
8-bit binary, twos complement numbers. The contents of AC, the contents of E, and the Carry Flag, 
CY/L, are added, and the sum is storedin AC. The initial contents of AC are lost; the contents of E 
are not altered. The Carry Flag, CY/L, is set if a carry from the most significant bit position occurs; 
otherwise, it fs cleared. The Overflow Flag, OV, is set if the sign of the result differs from the sign 
of both operands; otherwise, it is cleared. 


COMPLEMENT AND ADD EXTENSION TO AC (CAE) 


SOURCE STATEMENT INSTRUCTION FORMAT 


Mnemonic 7, 4 bo tt ty 9 
CAE 0 11#%i1éii1é00 0 


Operation: (AC) = (AC) + ~ (E) + CY/L; CY/L, OV 


The contents of the Accumulator, (AC), and the contents of the Extension Register, (E), are treated as 
8-bit binary, twos complement numbers. The contents of AC, the ones complement of the contents of 
E, and the Carry Flag, CY/L, are added, and the result is stored in AC. The initial contents of AC 
are lost; the contents of E are not altered. The Carry Flag, CY/L, is set if a carry from the most 
significant bit position occurs; otherwise, it is cleared. The Overflow Flag, OV, is set if the sign of 
the result is the same as the sign of the contents of E and opposite the sign of the contents of AC; 
otherwise, it is cleared. 


NOTE 


If the Carry Flag is set initially, this operation is 
equivalent to subtracting the contents of E from the 
contents of AC. 


4.1.6 Pointer Register Move Instructions 


The three single-byte instructions in this group are used for transfers between the Pointer Registers and the 
Accumulator or the Program Counter. The Pointer Register Move Instructions and mnemonics are as follows: 


Exchange Pointer Low. . . . . . .. . . . =XPAL 
Exchange Pointer High. . . . . . . . . . +. # #XPAH 
Exchange Pointer with PC. . . . . . . . . +. + XPPC 


The source statement format, the instruction format, and the description of each Pointer Register Move Instruc- 
tion follow. 


EXCHANGE POINTER LOW (XPAL) 


SOURCE STATEMENT INSTRUCTION FORMAT 


Mnemonic Operand 


XPAL ptr 


Operation: (AC)—»(PTR7.9) 
The contents of the Accumulator, (AC), are exchanged with the contents of the low-order byte (bits 7 
through 0) of the designated Pointer Register, (PTR). 
EXCHANGE POINTER HIGH (XPAH) 
SOURCE STATEMENT INSTRUCTION FORMAT 


Mnemonic Operand 


XPAH ptr 


Operation: (AC)—»(PTR 15.9) 


The contents of the Accumulator, (AC), are exchanged with the contents of the high-order byte (bits 15 
through 8) of the designated Pointer Register, (PTR). 


EXCHANGE POINTER WITH PC (XPPC) 


SOURCE STATEMENT INSTRUCTION FORMAT 


00 111 1] ptr 


The contents of the Program Counter, (PC), are exchanged with the contents of the designated Pointer 
Register, (PTR). 


Mnemonic Operand 


XPPC ptr 


Operation: (PC)——»( PTR) 


4.1.7 Shift, Rotate, Serial Input/Output Instructions 


The five single-byte instructions in this group shift or rotate the Accumulator or perform serial input/output 
operations using the Extension Register. The Shift, Rotate, and Serial Input/Output Instructions and mnemonics 
are as follows: 


Serial Input/Output. . . . . . . . . . . . SIO 

Shift Right . . . . . . . . . . . . . . SR, SHR 
Shift Right with Link . . . . . . . 2. 2. «. . SRL 
Rotate Right. . . . . . . . . . . . . «+ RR, ROR 
Rotate Right with Link. . . . . . . . . . . RRL 


The source statement format, the instruction format, and the description of the operation of each Shift, Rotate, 
or Serial Input/Output Instruction follow. 
SERIAL INPUT/OUTPUT (SIO) 

SOURCE STATEMENT INSTRUCTION FORMAT 


Mnemonic 


SIO 


Operation:  (E,) -(E,_,), SIN-=(E,), (Ej) = SOUT 


The contents of the Extension Register, (E), are shifted right one bit. The initial content of bit 0 is 
shifted to the serial data output latch and appears on the output pin SOUT. The signal on the data input 
pin SIN is shifted into bit 7. 


EXTENSION REGISTER 


SHIFT RIGHT (SR, SHR) 


SOURCE STATEMENT INSTRUCTION FORMAT 


Mnemonic 


SR 
SHR 


Operation: (AC;) = (AC;_1), 0 ~(ACz) 


The contents of the Accumulator, (AC), are shifted right one bit. The initial content of bit 0 is lost. 
Zero is shifted into bit 7. 


- - -»LOST 


SHIFT RIGHT WITH LINK (SRL) 
SOURCE STATEMENT INSTRUCTION FORMAT 


Mnemonic 


SRL 


Operation: (ACj) = (ACj-1), CY/L — (AC7) 


The contents of the Accumulator, (AC), are shifted right one bit. The initial content of bit 0 is lost. 
The Link Flag, CY/L, is shifted into bit 7. The Link Flag is not altered. 


¢ i 1 i ! ! t t 0 
CY/L -- = ACCUMULATOR - - -» LOST 
ROTATE RIGHT (RR, ROR) 
SOURCE STATEMENT INSTRUCTION FORMAT 
Mnemonic 
RR 
ROR 


The contents of the Accumulator, (AC), are rotated right one bit. The initial content of bit 0 is shifted 
into bit 7. 


ROTATE RIGHT WITH LINK (RRL) 
SOURCE STATEMENT 


Mnemonic 


RRL 


Operation: (AC;) = (AG_7), (ACg) = CY/L > (ACz) 


The contents of the Accumulator, (AC), are rotated right one bit. The initial content of bit 0 is shifted 
into the Link Flag, CY/L, and the initial content of the Link Flag is shifted into bit 7 of AC. 
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4.1.8 Miscellaneous Instructions 


There are nine instructions in this group, eight single-byte, and one double-byte. The Miscellaneous Instructions 
and mnemonics are as follows: 


Halt . 2. 6. we ee ee e”S:CX AA LL 
Clear Carry/Link . . . . . . . . eC 
Set Carry/Link . . . . . . . hehehe ti‘ ae”*”*é«CSE 
Disable Interrupt . . . . . . . . . . . . =DINT 
Enable Interrupt. . . . . . . . . . . . +.  £=xJEN 
Copy Status toAC . . . . . . .hehee CSA 
Copy AC to Status . . . . . . 2. 2. ee ee CAS 
No Operation. . . 2. 2. 2. 2 6 ee ee NOP 
Delay. . 2. 2. wee lk DLY 


The source statement format, the instruction format, and the description of each Miscellaneous Instruction 
follow. 


HALT (HALT) 


SOURCE STATEMENT INSTRUCTION FORMAT 


00000 0 0 0 


The H-flag and the CONTinue input may be combined to generate a programmed halt of the microprocessor. 
However, ina particular application system, this instruction may be used for functions other than HALT. 
For detailed information on the hardware operation of the halt instruction, see the SC/MP data sheet. 


Mnemonic 


HALT 


Operation: Pulse H-flag at I/O status time. 


CLEAR CARRY/LINK (CCL) 


SOURCE STATEMENT INSTRUCTION FORMAT 


Mnemonic 


CCL 


Operation: CY/L — 0 


The Carry/Link Flag, CY/L, in the Status Register is cleared. The remaining bits in the Status Register 
are not affected. 


SET CARRY/LINK (SCL) 


SOURCE STATEMENT INSTRUCTION FORMAT 


Mnemonic v, yor oro , 0 
SCL 


00000011 


Operation: CY/L~— 1 


The Carry/Link Flag, CY/L, in the Status Register is set. The remaining bits in the Status Register are 
not affected. 
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ENABLE INTERRUPT (IEN) 


SOURCE STATEMENT INSTRUCTION FORMAT 


Mnemonic 7 robot bole 0 
IEN 000 0 01 0 1 
Operation: IE —< 1 


The Interrupt Enable Flag, IE, in the Status Register is set; the remaining bits in the Status Register 
are not affected. The processor interrupt system is enabled. Interrupts will be processed as received 
after the next instruction is fetched and executed. (See 2.5 and 5.6.2.) 


DISABLE INTERRUPT (DINT) 


SOURCE STATEMENT INSTRUCTION FORMAT 


Mnemonic 7, roropo py 9 
DINT 0 00 001 0 0 


Operation: IE —< 0 
The Interrupt Enable Flag, IE, in the Status Register is cleared; the other bits in the Status Register 
are not affected. The processor interrupt system is disabled. Interrupts which occur while the system 
is disabled will not be processed. 

COPY STATUS TO AC (CSA) 


SOURCE STATEMENT INSTRUCTION FORMAT 


Mnemonic 


CSA 


Operation: (AC) —— (SR) 
The contents of the Status Register, (SR), replace the contents of the Accumulator, (AC). The initial 
contents of AC are lost; the contents of SR are not altered. 
COPY AC TO STATUS (CAS) 
SOURCE STATEMENT INSTRUCTION FORMAT 
Mnemonic 


CAS 00000111 


Operation: (SR)—« (AC) 


The contents of the Accumulator, (AC), replace the contents of the Status Register, (SR). SR bits 4 and 
5 are external sense bits and are not affected by this instruction. The initial contents of SR (except for 
bits 4 and 5) are lost; the contents of AC are not altered. See Status Register diagram on the following 


page. 
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7, 6, 5,4, 3,2, 1 =, 0 


ACCUMULATOR 


STATUS REGISTER 


If IE is changed from 0 to 1 by this instruction, the interrupt system will be armed after the next 
instruction is fetched and executed (see 2.5 and 5.6.2). 


NO OPERATION (NOP) 


SOURCE STATEMENT INSTRUCTION FORMAT 


Mnemonic 7, oy tl tt tt 9 
NOP 000010 0 0 
Oper ation: (PC) —— (PC) +1 


The contents of the Program Counter, (PC), are incremented by 1. The NOP instruction takes the 
minimum 5-microcycle execution time. Undefined opcodes encountered are considered to be one-byte 

or two-byte NOPs and may take 5 to 10 microcycles to execute depending on the code. It is recommended 
that only the Opcode 08 be used to insure software compatibility with future products. 


DELAY (DLY) 


SOURCE STATEMENT INSTRUCTION FORMAT 


Mnemonic Operand 
DLY data 


byte 1 


Operation: | DELAY = 13 + 2(AC) + 2 data + 29 data 


This instruction delays processing a variable length of time. The contents of the Accumulator, (AC), 
and the data byte are considered unsigned binary numbers (maximum value of each is 255). The number 
computed from the given equation is the execution time in microcycles. The following table gives some 
typical execution times. Range of delay is from 13 to 131593 microcycles. 
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AC 


0 
1 
2 
3 
4 
data 5 
6 
7 
8 
9 
10 
To determine AC and data for a specific number of microcycles (m) use the following equations: 
data = truncate ((m-13)/514) 
AC = ((m-18) - 514(data)) /2 
Using these equations, the delay time will be either exact or one microcycle less than the 
required number of microcycles. 
4.2 COMMENT STATEMENTS 


Comment statements are defined by a semicolon (;) in the first character position of the record. They do not 
generate code, but serve only to document the symbolic output listing of the program. For example: 


; 
;THIS IS A COMMENT STATEMENT 


9 


4.3 PSEUDO INSTRUCTION 


A pseudo instruction is an assembler-dependent source statement that generates one or multiple machine-language 
instructions. Functionally, the pseudo instruction operates the same as a macro instruction (see chapter 6 for 
details on Macros). The difference between the two types of instructions is that the code to be generated by the 
pseudo instruction is defined in the assembler, while the code to be generated by the macro instructions is de- 
fined in the macro definitions, which are independent of the assembler (macro definitions normally reside in the 
user's program). 


The Jump to Subroutine (JS) is the only pseudo instruction statement implemented in the SC/MP assembler. The 
statement is described on the following page. 
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JUMP TO SUBROUTINE (JS) 
SOURCE STATEMENT 


Mnemonic Operands 


JS ptr, expression 
Generated Code:  LDI H(expression - 1) 
XPAH ptr 
LDI L(expression - 1) 
XPAL ptr 
XPPC ptr 


H(expression - 1) and L(expression - 1) are not legal notation for the assembler, the assembler 
accepts only symbols in the H( ) and L( ) functions, and not expressions (symbol - 1 is considered 
an expression). What actually happens is that the assembler generates the value expression - 1 
(taking into account page boundaries), and then applies the H( ) and L( ) functions to the value. 


When a Jump to Subroutine is invoked, the code generated results in the setting of the specified Pointer Register, 
ptr, to the value, expression - 1. When calculating expression - 1, the 4K memory page structure of SC/MP is 
taken into account. As a result, the next instruction to be executed will always be the instruction addressed by 
expression. 


This feature is important when addressing page boundaries. For example, if you wanted to jump to the beginning 
of page 3 (location X'2000), you might code the following sequence of instructions. 


PG3 = PAGES - 1 sSET PG3 = X'1 FFF 
LDI H(PG3) 3LOAD X'1F INTO AC 
XPAH P38 ;s TRANSFER AC TO BITS 15-8 OF P3 
LDI L(PG3) ;LOAD X'FF INTO AC 
XPAL P83 ;TRANSFER AC TO BITS 7-8 OF P3 
XPPC 3 ;PC NOW CONTAINS X'1FFF 
PAGES: . =X'2000 


The above code would work for any location other than a page boundary. But, because of the wrap around feature 
of SC/MP (see 2.3.1, Paging Considerations), the next instruction fetched will be from location X'1000 rather 
than location X'2000. What you should do in this example is to code the following sequence of instructions. 


JS P3, PAGES 


PAGES: . =X'2000 


When the JS instruction evaluates expression - 1 for a value to be used in the H( ) and L( ) functions, the 
assembler recognizes that expression (PAGE3) is a page boundary, so instead of setting value to X'1FFF it 
sets it to X'2FFF. Wrap around still occurs, but since the PC contains X'2FFF after the XPPC 3 instruction, 
the next instruction is fetched from location X'2000. 
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4.4 ASSIGNMENT STATEMENT 
[label] symbol = expression [;comments] 


The Assignment Statement assigns the value of the expression on the right of the equals sign to the symbol on 
the left of the equals sign. The Statement may be preceded by a series of labels. 


Example: 


RETURN = 0D 35 YMBOL HAS CARRIAGE RET CODE 


The Assignment Statement may set the location counter or refer to the current value of the location counter in 
an expression. The location counter assigns addresses to program statements at assembly time. It is similar 
to the Program Counter, which contains the address of the next instruction to be executed at execution time. As 
each instruction or data area is assembled, the location counter always points to the next available location in 
memory. 


The period '.' is a special symbol used to specify the location counter. The location-counter symbol may appear 
on either side of the equals sign. If it appears on the left, it is assigned the value on the right side of the equals 
sign. The programmer may refer to the current setting of the location counter by referencing the '.' in the 
expression to the right of the equals sign. Assignment statements using the location-counter symbol are coded 
as free-form statements. For example: 


. =20 sSSET LOCATION COUNTER TO 20 
TABLE: .=.+10 sSRESERVE 10 LOCATIONS FOR TABLE 


If the '.' appears on the left, the expression on the right must be defined during the first pass so subsequent 
label assignments may be made. 


If the symbol on the left is not '.', then the expression on the right need not have a value during the first pass, 
but the expression must have a value during the second pass. This permits only one level of forward referencing. 
An example of more than one level of forward referencing follows: 


FST: A=B+2 This expression undefined during pass 2. 
SND: B=C-1 This expression undefined during pass 1. 
THD: C=25 This expression absolute 

4.5 DIRECTIVE STATEMENTS 


The Directive Statements control the assembly process and may generate data in the object program. The 
directive operator may be preceded by one or more labels, and may be followed by a comment. It occupies 
the operator field and is followed by either no operand or as many operands as are required by the particular 
operator. 


Assembler directive operators and their functions are summarized in table 4-4. Note that all directive operators 
begin with a period for easy visual differentiation from the instruction operator mnemonics in the output listing. 
Each directive operator is described in more detail in the following paragraphs. 
4.5.1 . TITLE Directive 

[label] . TITLE symbol [, string] [;comments] 
The . TITLE directive identifies the load module in which it appears with a symbolic name and an optional 
definitive title. If a . TITLE directive does not appear in the program, the load module is given the name 


MAINPR. If more than one . TITLE directive is used, the last one encountered specifies the symbolic name. 


The symbolic name and the string must meet the symbol and string construction restrictions discussed in 
chapter 3. 


Example: 


.-TITLE TBLKP,'TABLE LOOKUP' 
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Table 4-4. Summary of Assembler Directives 


Directive Function 


. TITLE 
. END 

. LIST 
.SPACE 
. PAGE 

. BYTE 

. DBBYTE 
. ASCII 

. LOCAL 
.IF 

. ELSE 

. ENDIF 
. FORM 

. ADDR 
SET 

. MACRO 
. ENDM 

. MLOC 

. DO 

. ENDDO 
. EXIT 

. IFC 

. ERROR 
. MDEL 


Identification of program. 

Physical end of source program. 
Listing output control. 

Space n lines in output listing. 

Output Listing to top-of-form. 

8-bit (single-byte) data generation. 
16-bit (double-byte) data generation. 
Data generation for character strings. 
Establish a new local symbol region. 


Conditional Assembly 


Field Specification. *** 
Address constant generation. 
Assign values to variables. 
Begin macro definition. * 
End macro definition. * 
Macro Local Symbols. * 
Begin Macro-time looping. * 
End Macro-time looping. * 
Exit Do loop. * 

Conditional Assembly. ** 
Macro error message generation. ** 
Macro delete. ** 


* Used only in macro definitions; see chapter 6 for 
descriptions. 
**k Macro related directive; see chapter 6 for descriptions. 
*** Not in assemblers with macros. 


4.5.2 . END Directive 


[label] . END [address] [scomments] 


The . END directive signifies the physical end of the source program. The optional address in the operand 
field may be either a symbol or a constant and indicates an execution address to a loader. In other words, 
it causes a branch to the address of the first executable instruction (entry point in contrast to load point) 
after the load is complete. The . END directive just makes the entry point address available to a loader. 
Use of this feature is dependent on the loader program. 


Examples: 


1. No entry point specified 
LAST: . END 


2. Jump to the entry point at X'00A9 


-END X'00A9 Loader Dependent Option 


3. Jump to the entry point labeled START 
~END START 
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4.5.3 . LIST Directive 

[label] . LIST immediate [s;comments] 
The . LIST directive controls listing of the source program. This includes listing in general, listing of un- 
assembled code caused by the . IF and . IFC directives, listing of macro expansions, and listing of generated 


code. 


Control of the various list options depends upon the state of the five least significant bits of the evaluated ex- 
pression in the operand field. Table 4-5 shows the options available in the order of their priority. 


Options are usually combined to give the desired type of listing. Some examples follow: 


1, Full listing: 


.LST 01 
2. Full listing and list all code expanded during macro calls. 
- LIST 0D Full list 
or 
.LIST 01 ! OC ~——— list all code expanded during macro calls 


3. Suppress listing. 
. LIST 0 


Table 4-5. List Options 


a 


Master List Control * Full listing 
Suppress all listing 


. IF List Control 


Full listing (of .IF's and . IFC's) 
* Suppress unassembled code 


Macro List Control List all code expanded during macro calls 
List only code generated by macro calls 


* List only macro calls 


Binary List Control * List all the binary output by statements 
generating more than one word (e.g., 
. ASCII) 
List only the first two bytes of generated 


data 


* indicates default 


4.5.4 . SPACE Directive 
[label] .SPACE immediate [;comments] 
The .SPACE directive skips forward a specified number of lines on the output listing. 


Examples: 


1. Skip 20 (decimal) lines 
-.SPACE 20 


2. Skip 20 (hexadecimal) lines 


~-SPACE 020 
or 
~SPACE X'20 
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4.5.5 . PAGE Directive 
[label] . PAGE [string] [;comments] 


The . PAGE directive spaces forward to the top of the next page on the output listing. The optional string is 
printed as a page title on each page until a . PAGE directive containing a new string is encountered. No action 
is taken (except for a new page title) if the . PAGE directive is encountered immediately after an assembler 


generated top-of-page request. 
Example: 


~PAGE ‘TTY I/O ROUTINES! 


4.5.6 . BYTE Directive 
[label] - BYTE expression[,expression... ] [;comments] 


The . BYTE directive stores consecutively in memory one 8-bit byte for each given expression. If the directive 
has a label, it refers to the address of the first expression. The value of each expression must be in the range, 
-128 to +127 for signed data or 0 to 255 for unsigned data. 


Examples: 


1. Single expression without a label 


-BYTE X'FF 
2. Multiple expressions with a label 
TBL: .BYTE MPR+10, X'FF, X'00 
NOTE 


TBL is assigned the location counter value of the 
byte containing the expression MPR+10. 


4.5.7 . DBYTE Directive 


[label] . DBYTE expression[, expression... ] [;comments] 


The .DBYTE directive stores 16-bit data in two consecutive 8-bit memory locations. Each expression of a 
. DBYTE directive is evaluated, and its value is placed in the next available pair of memory locations. The 
value of each expression must be in the range, -32768 to +32767 for signed data or 0 to 65535 for unsigned data. 


The .DBYTE directive generates 16-bit address constants for use with Memory Reference or Memory-Increment/ 
Decrement Instructions (4.2.1 and 4.2.2). If the directive has a label, it refers to the memory address of the 
first byte generated by the directive. 


Examples: 


1. Without a label 
~-DBYTE X'77FF 
2. With a label 
LABL: .DBYTE X'77FF 
NOTE 


LABL is assigned the value of the location of X'77 
and LABL + 1 is assigned the value of the location 
of X'FF. 


A single character string appearing in a .DBYTE generates an 8-bit right-justified constant. 
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4.5.8 . ADDR Directive 
[label] . ADDR expression[, expression... ] [;comments] 


The .ADDR directive generates 16-bit address constants to be used by transfer instructions. Each expression 
in the directive is evaluated, is decremented by 1, and then is placed in the next available pair of memory bytes. 
The decrementing takes into account the modulo-4096 address arithmetic used in SC/MP. 


The effect of this directive is that if a pointer register is loaded with the resulting constant and its contents are 
exchanged with the program counter, the next instruction to be executed will be the one addressed by the value, 
expression. 


Example: 
AD1: - ADDR OUTPUT 
LD AD1 
XPAH P3 
LD AD1+1 
XPAL P3 
XPPC P3 


The subroutine OUTPUT is executed. 


4.5.9 ASCII Directive 


[label] . ASCII string [, string... ] [;comments] 


The .ASCII directive stores data in successive memory locations by translating the characters in the string 
into their 7-bit ASCII equivalent code. Each string must be enclosed in single quote marks ('). Each character 
occupies one byte in memory. The .ASCII directive is used primarily to generate messages for output on tele- 


typewriter or printer. 


Example: 


-ASCH 'INPUT OF VALUE OF X'! 


4.5.10 .LOCAL Directive 
[label] » LOCAL [;comments] 


The . LOCAL directive establishes a new program section for local symbols (symbols beginning with a dollar 
sign ($)). Designated symbols between two . LOCAL directive statements have the value assigned to them only 
within that particular section of the program. Note that a .LOCAL directive is assumed at the beginning and the 
end of a program; thus, one . LOCAL directive within a program divides the program into two sections. 


If the first character of a symbol is a dollar sign ($), the assembler attaches a unique character from the ASCII 
character set to the end of the symbol. Initially, this character is an exclamation point '!' (X'21). Each time a 
. LOCAL directive is encountered, the value of the added character is advanced by one with the letter "Z" (X'5A) 
as the last legal value. Therefore, up to 58 . LOCAL directives can appear in one assembly. 


Example: 


» LOCAL 
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4.5.11 Conditional Assembly Directives 


[label] IF expression {;comments] 
. ELSE [;comments] 
. ENDIF {;comments] 


The conditional assembly directives selectively assemble portions of a source program based on the value of 
the expression in the . IF directive statement. 


All source statements between a . IF directive and its associated . ENDIF are defined as a . IF-. ENDIF block. 
These blocks can be nested to a depth of ten. The . ELSE directive can be included optionally in a . IF-. ENDIF 
block. The . ELSE directive segments the block into two parts. The first part of the source statement block is 
assembled if the .IF expression is greater than zero; otherwise, the second part is assembled. When the . ELSE 
directive is not included in a block, the block is assembled only if the .IF expression is greater than zero. If 

an error is detected in the expression, the assembler assumes a true value (greater than zero). 


Examples: 


1. Two-part conditional assembly 


IF COMPR 
Assembled if COMPR greater than zero 

_ ELSE 
Assembled if COMPR less than or equal to zero 

. ENDIF 

2. Nested . IF-. ENDIF block conditional assembly 
. IF SMT 

) Assembled if SMT is greater than 0 


Assembled if 
OBR is greater 
than zero and : Assembled if SMT is less than 
SMT is less than or equal to zero 

or equal to zero 


. IF OBR 


. ENDIF 


) 


Labels appearing on .IF statements are assigned the address of the next assembled instruction. Labels cannot 
be used on .ELSE or . ENDIF statements. 


. ENDIF 


Listing of unassembled code may be controlled by appropriate use of . LIST directives (see paragraph 4. 5. 3). 


4.5.12 . FORM Directive * 
[label] . FORM symbol, exp[(exp)] [, exp(exp)...] [;comments] 
The . FORM directive specifies a field format for an 8-bit byte and optionally presets bits of the word to an 


initial value. The . FORM directive may be used for generating special instructions not recognized by the 
assembler. 


* Not available in the SC/MP (PACE) Cross Assembler 
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Symbol is the name of the byte format. Format is invoked by placing the symbol in the operation field of a state- 
ment. Note that symbols assigned values by the . FORM directive can be used only as operation symbols. 


The expressions that follow the symbol specify field lengths within the byte and, optionally, the expressions con- 
tained in parentheses specify values for the specified fields starting at the most significant bit. If a value is 
specified for a field, it must be enclosed in parentheses and immediately follow the length attribute. 


Examples: 
1. .FORM CK, 2,4, 2(X'3) divides the CK into 3 fields: one 2-bit field, one 4-bit field, and one 
2-bit field with the preset value X'3. The preset value field cannot be changed when the format 
is invoked. 


2. Generate binary strings 
.FORM  BINARY,1,1,1,1,1,1,1,1 
When the BINARY format is invoked by 
BINARY 1,0,1,1,0,0,1,1 


It causes the number B3j¢ to be generated. 


4.5.13 .SET Directive 


[label] .SET symbol, expression [;comments] 


The .SET directive is used to assign values to reassignable (set) variables. A variable assigned a value with 
the .SET directive can be reassigned different values an arbitrary number of times. 


Examples: 
SET A, 100 sSET A = 100 
SET B, 50 sSET B= 50 
.SET C,A-25*B/4 SSET C=A —- 25 * B/4 
NOTE 


This expression is always evaluated from left to 
right regardless of the operators used between 
the variables and constants. 
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Chapter 5 


PROGRAMMING TECHNIQUES 


This chapter discusses the programming techniques used to produce efficient SC/MP object code. Examples of 
coding are included to illustrate the method by which the techniques are implemented. 


o. 1 STACK PROGRAMMING 


A convenient way of temporarily saving status and return addresses from subroutines and interrupt service 
routines is to maintain a stack in read/write memory. An advantage of a software stack compared to a hard- 
ware stack is that the hardware stack is limited in size to a fixed number of storage locations; any additional 
data pushed onto a stack cause an overflow and loss of data at the bottom of the stack. A software stack, on 
the other hand, virtually can be made any length, so overflow cannot occur. Another advantage of using soft- 
ware stacks is that more than one stack can be maintained. 


System software may use the following pointer register assignments: 


Pointer Register Function 
Pl ROM Pointer and miscellaneous 
P2 Stack Pointer 
P3 Subroutine Pointer 


Storing and retrieving data from the stack are accomplished by the following methods: 


1. Store one byte of data or address 

CE0O ST @-1(P2) *PUSH A BYTE ONTO THE STACK 
2. Retrieve one byte of data or address 

C601 LD @1(P2) ;PULL A BYTE OFF THE STACK 


It should be noted that the auto-indexing feature is used to move the stack pointer address up or down the stack. 
The stack pointer (P2) always points to the last value pushed onto the stack. 


5.1.1 Stack Operations 


Using the stack conventions previously stated creates a stack that begins in high memory and extends downward. 
The most effective method of using this stack consists of fixing the base location of the stack, allocating any per- 
manent locations required by the program, and then allowing the dynamic portion of the stack to expand and contract 
below that. For example see the following page. 
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Base 
(high memory) 


Start 


(low memory) 


Permanent Area — contains global data for one or more 
programs. Fixed structure. 


Dynamic Area — used by a particular program or sub- 
routine at a particular time. The structure of this area 
depends upon the state of the system. 


The permanent area of the stack always may be accessed by providing two words (labeled STKPT) for saving 
the stack pointer and then using the following code. 


0004 


FFFE 


» PAGE 
BASE 


=. sPERM. AREA OF STACK 


L (BASF) 
P2 
;SAVE LO-HALF OF PTR 
H (BASE) 
P2 
STKPT (E2) 


STKPT+1 (P2) 


Loading a Pointer from a word-pair pointed to by the same pointer. 


LD 
XAE 
LD 
XPAL 
LDE 
XPAH 


0(P2) sLOAD UPPER POINTER ADDRESS 
sSAVE 

1(P2) sLOAD LOWER POINTER ADDRESS 

P2 sTRANSFER TO LOWER P2 
RESTORE UPPER ADDRESS 

P2 sTRANSFER TO UPPER P2 


5.1.2 Repeatable Subroutine Calls 


If P3 is being used as a subroutine pointer, the subroutine may be called repeatably without reloading P3 as 
long as P3 is not disturbed. The subroutine must be set up as follows: 


SIN: 


ay XPPC P3 
90FD JMP SIN 


-SUBROUTINE RETURN 
-FOR REENTRY 


All other things being equal, subroutines should be coded as repeatable. 


0.2 SUBROUTINES 


Because of the problems involved when a program crosses a page boundary, it is suggested that the programmer 
code his programs in modules smaller than a page. Organizing code into small subroutines is a more efficient 
way of coding, since it is easier to verify several small subroutines than one large program. 


There are two methods used to implement subroutines, depending on whether the subroutine is single level or 
nested. Nesting is a condition where a subroutine contains calls to other subroutines. 


De uk Multilevel Subroutines 


To implement multilevel (nested) subroutines, a stack must be created in memory. As an example, pointer P2 
could be defined as the stack pointer. The address loaded into P2 would point to the top of the stack. This 


address would be a location in read/write memory. 


If nesting is not required, subroutines can be called using the pointer registers to save the return address. 


The following examples assume that SUBR is the label on the first instruction of the subroutine. It should be 
noted that the examples will not work on a page boundary (see 4.3, Pseudo Instruction, for the explanation). 


SUBROUTINE JUMP 


0015 SUBR1 = SUBR-1 
C415 LDI L (SUBR1) 
33 XPAL P3 

C400 LDI H(SUBR1) 
37 XPAH P3 

3F XPPC. P3 


SUBROUTINE RETURN 


3F XPPC P3 


;LOAD LOWER SUBROOTINE ADDRESS 
sFRANSPER LOWER TO P3L 

;LOAD UPPER SUBROUTINE ADDRESS 
> TRANSFER UPPER TO P3H 

> EXCHANGE PC AND P3 


sRETURN FROM SUBROUTINE EXCHANGE 


If multilevel subroutines are used, the current contents of the pointer register should be saved on the top of the 


stack and should be restored upon return from the subroutine. 


C415 LDI L (SUBR1) 
33 XPAL P3 

CEFP ST @-1(P2) 
C400 LDI H (SUBR1) 
37 XPAH P3 

CEFF ST @-1(P2) 
3F XPPC P3 

C6FF LD @-1 (2) 
37 XPAH P3 

C601 LD @1(P2) 
33 XPAL P3 


;LOAD LOWER SUBROUTINE ADDRESS 
sTRANSFER TO P3 

sSAVE P3L ON STACK 

;LOAD UPPER SUBROUTINE ADDRESS 
sTRANSFER TO P3H 

;SAVE P3H ON STACK 

sJUMP TO SUBROUTINE 

;RETURN FROM SUBROUTINE, LOAD P3H 
;FROM STACK 

sTRANSPER TO P3H 

;LOAD P3L FROM STACK 

sTRANSFER P3L, BACK TO NORMAL 


5.222 Jump Immediate 

A jump immediate can be implemented directly using the subroutine jump as shown in example 5.2.1 but without 
executing a subroutine return. This facility allows a jump to any address in memory. 

5.2.3 Conditional Subroutine Jumps 


Conditional subroutine jumps can be implemented using a condition jump test to bypass the subroutine call. For 
example: 


9400 JP NOJSR -NO SUBROUTINE JUM® IF AC POSITIVE 
e e 
@ e 
° SUBROUTINE CALL AS IN OTHER EXAMPLES 
° : 
NOJSR: 
@ @ 
e e 
e r) 


5.2.4 Multiple Subroutine Return 


The same programming technique described in 5.2.1 can be used to establish more than one return address after 
a subroutine has been executed. This technique can be used to test a flag condition and to branch conditionally to 
one of two or more locations, depending upon the condition of the flag. For example, a subtract routine might 
require three returns: one for a positive result, one for a negative result, and one for a zero result. 


The example below affects a conditional call from a subroutine on the current page. 


C432 LDI LOWER >LOAD LOWER RETORN ADDRESS 
33 XPAL P3 
CRFP ST a@-1(P2) >PUSH ONTO STACK 
C433 LDI UPPER *LOAD UPPER RETORN ADDRESS 
37 XPAH P3 
CEFF ST @-1(P2) ;PUSH ONTO STACK 
3F XPPC P3 sJUMP TO SUBROUTINE 
90EE JMP ZERO $ZERO RETURN 
90EC JMP POS *POSITIVE RETURN 
C8ED ST RESULT sNEGATIVE RETURN 
e e 
e e 
TESTI: 
e e 
@ @ 
@ e 
c601 LD @1(P2) ;LOAD UPPER RETURN ADDRESS 
37 XPAH P3 *TRANSFER TO P3 HIGH 
c601 LD @®1(P2) sLOAD LOWER RETURN ADDRESS 
33 XPAL P3 sTRANSFER TO P3 LOW 
40 LDE *GET RESULTS PROM EXTENSION 
9807 JZ RETURN sJUMP IF AC=0 
C702 LD @2(P3) s INCREMENT RETURN ADDRESS 
40 LDE : ‘GET RESULTS FROM EXTENSION 
9402 JP RETURN sJUMP IP ac>0 
C702 LD @2 (P3) sAC<O, INCREMENT RETURN 
3F RETURN: XPPC P3 ; EXCHANGE P3 AND PC 
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5.2.5 Transferring Data to Subroutines 

Frequently parameters must be passed to a subroutine when it is called; this is accomplished by listing the 
parameters in the bytes following the subroutine call and by incrementing the return address to the next exe- 
cutable instruction. Below is an example of the coding for this data-transfer technique: 


C400 JS P3,MATH ;JOUMP TO SUBROUTINE 
37C4 
£433 
3F 
01 BYTE X'O1 32 BYTES PASSED TO 
02 - BYTE X*02 ; SUBROUTINE 

e e 

e ® 

e e 
C701 MATH: LD @1(P 3) sADJUST PTR TO 1ST PARAMETER 
c701 LD @21(P3) s;FETCH PARAMETER 
C&EF ST PARM1 
C300 LD (P3) ; FETCH PARAMETER 2 
C8EC ST PARM 2 


At this point, the return address is in P3. The programmer may elect to leave it in P3, save it on the stack or 
store it locally until it is needed to return from the subroutine. 


It also may be convenient to store all of the subroutine input parameters on the stack before calling the subrou- 
tine and then to have the subroutine place any output parameters on the stack before executing a return. 


5.3 LOOP COUNTER 


When executing a routine in which a group of instructions is repeated a given number of times, it may be con- 
venient to use a memory location as a counter register. The address of the memory location used as a counter 
would be stored in one of the pointer registers. 


An advantage of the use of a memory location as a counter rather than as an internal register (such as E) that is 
the Increment and Load (ILD) and the Decrement and Load (DLD) Instructions associated with memory-location 
increments and decrements do not affect the value of the carry bit in the status register. This is particularly 
important in serial arithmetic operations, where the carry bit must be saved for the next step. 


It should be noted that both the ILD and DLD instructions destroy the contents of the accumulator, so the contents 
of the accumulator should be saved temporarily if they are needed in additional calculations. 


The following exemplifies the implementation of a memory counter for a program containing a loop that is to be 
executed eight times. 


C468 LDI H (CNTR) ;LOAD HIGH ORDER ADDRESS OF COUNTER 
35 XPAH Pl ;P1 AS COUNTER POINTER 
C41E LDI L (CNTR) ;LOAD LOW ORDER ADDRESS OF COUNTER 
31 XPAL Pl ;P1 AS COUNTER POINTER 
C468 LDI 8 ;LOAD NUMBER OF TIMES TO LOOP 
C900 ST (Pl) ;STORE COUNTER VALUE IN MEMORY 
° ° 
e ® 
LOOP: 
Ld e 
° e 
e e 
33 XPAL P3 ;SAVE AC IN P3L 
B900 DLD 0 (P1) ;DBCREMENT COUNTER 
9803 JZ NEXT ;IF COUNTER=0, END OF LOOP 
33 XPAL P3 ;RECOVER AC FROM P3L 
90F8 JMP Loop ;REPEAT LOOP 
33 NEXT:  XPAL P3 ;RECOVER AC FROM P3L 


In a similar manner, the counter and temporary storage for the AC can be saved on the stack, thereby eliminat- 
ing the overhead of initializing Pl (in the preceding example). The Extension Register may also be used as 
temporary storage for saving the Accumulator. 


5.4 PAGE CONSIDERATIONS 


PC-relative memory-reference instructions can reference memory only within the current page (4096 bytes), and 
then only +127; this requires the programmer to take certain precautions and to use the techniques described in 
this section to avoid problems at page boundaries. 


5.4.1 Instructions at the Page Boundary 


The program counter does not automatically increment across page boundaries, but does effect a "wrap-around" 
in the same page. Therefore, a 2-byte instruction might occupy the last two bytes of a page or the last and first 
byte of the same page, but not the last byte of one page and the first byte of the next page. The assembler flags 
the condition of a 2-byte instruction whose first byte is at the page boundary so the programmer can modify the 
source code. 


5.4.2 Programs Residing Across Page Boundaries 


Since PC-relative memory references are limited to the page occupied by the instruction, the simplest way of 
writing a program is to organize it as short subroutines, each of which resides within one page of memory. It 
is advisable usually not to fill a page with one subroutine, since corrections that require additional program 
steps could not easily be incorporated. 


If the user wants to continue his program across a page boundary, he must explicitly set the location counter and 
he must use the Jump to Subroutine (JS) pseudo instruction. For example: 


JS P3, PAGE3 3J UMP TO PAGE 3 


PAGES: . =X'2000 


This example jumps to first location of page 3. For any location other than the first location of a page, the code 
shown in 5.2.1 will work (see 4.3, Pseudo Instruction, for the explanation). The user should be aware that if he 
uses the JS instruction, the contents of the Accumulator are lost. 


Using indexed addressing, it is relatively simple to write programs that occupy more than one page of memory. 
The first instruction on each page loads a pointer register with the alternate page address; indexed addressing 
is used to reference the alternate page, and PC-relative addressing is used to reference the current page. The 
techniques used to load a subroutine address apply here. 


9.5 TEXT PROGRAMMING TECHNIQUES 


When programs require extensive dialog, textual display, or printout, attention should be given to the technique 
that programs the textual printout, since it is likely to be subject to modification. One technique that readily 
lends itself to the SC/MP is the literal pool. A literal pool is an area within an assembled program where the 
literals used within the program are stored. Within the literal pool, all duplication of text is eliminated. For 
example, consider the following five messages: 

ENTER 5 COEFFICIENTS 


COEFFICIENT OUT OF ALLOWED RANGE. RE-ENTER 


ANOTHER ? 


1 
2 
3. ANSWER = 
4 
9) NO VALID ANSWER. RE-ENTER 5 COEFFICIENTS 
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Text for the five messages may be stored in a literal pool as shown below. 


Messages are created by indexing the literal pool using a 2-byte repeating sequence. 
ment from the base of the literal pool to the first required character. 


Li: e~ASCII 
L2: -ASCII 
L3: ~ASCITT 
L4&: ~ASCIT 
LS: ~ASCII 
Lf: ~ASCIT 
L7: -ASCTI 
L8: -ASCIT 
LY: ~-ASCII 
L10: ~ASCTI 
L111: ~=.+1 


',RE-! 


‘ENTER * 


1S! 
* COFFFICIENT® 


tse 
' CUT OF ALLOWED RANGE® 


*ANCTHER?'! 


"ANSWER! 


‘NG VALID ° 


Byte 1 holds the displace- 
Byte 2 holds the value of the number of 


characters to be printed. If the first byte of the byte pair holds the value X'FF, it signifies the end of the 


message; otherwise, another segment of the message is sought in the next byte pair. 


Each of the five messages 


described above could be created by the index sequence shown below. 


04 
14 
FF 
QB 
OC 
198 


Ti: ~-RvyTte 
~PYTE 
~RYTE 

T2: » BYTF 
~PYTE 
~BYTF 
oRYTE 
~3YTF 
~ BYTE 
~ BYTE 

13: ~fYTE 
~RYTE 
~ BYTE 

T4s BYTE 
BYTE 
~BYTE 

I5: - BYTE 
-BYTF 
BYTE 
- BYTE 
- BYTE 
BYTE 
~ BYTE 


L2-L1 sENTER 5 COEFFPICTIFNTS 
L6é-12 
Xt FF 
Lu-L1 
L5-L4 
LA-L1 
L7-Lé 
L1-L1 
L3-1L1 
X'FF 
L8-L1 
110-18 
X*FF 
L7-1L1 
L8-L? 
X* FF 
L10-1L1 
111-110 
L8-L1 
L9-L8 
L1-L1 
16-11 
X' FF 


; COEFFICIENT 
;CUT OF ALLOWED RANGE 


;-REENTER 


sANSWER= 


> ANOTHER? 


;NO VALID ANSWER 


3eREENTER 5 COEFFICIENTS 
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A subroutine generates the printed messages. To write a message, the procedure is to call the subroutine and 
to specify the index that identifies the message to be printed. For example, to print "Answer="", the call would 
be as shown below. 


3F XPPC P3 WRITE "ANSWER=" 


00DO0 ~-CBYTE 13 
RETURN POTENT 


Subroutine WRIT calculates the section of the literal pool to be printed. The first character is at the address: 
L1 plus the contents of I3. The number of characters to be printed is derived from the contents of I3 +1. The 
next byte contains X'FF, so printing is finished; otherwise, printing would continue with the next pair of index 

bytes specifying the next string of characters. 


5.6 INPUT AND OUTPUT PROGRAMMING TECHNIQUES 


The programming of data transfers between read/write memory and peripheral devices is generally classified 
as input/output programming. Depending on the significance of the input/output operations in the overall pro- 
gram, different approaches to input/output program implementation are recommended; these approaches are 
described in the following sections. 


5.6.1 Programmed Input/Output 


A programmed input/output operation is initiated and completed under the control of the initiating program. In 
figure 5-1, the program being executed starts the input/output operation; then, the program waits for the opera- 
tion to be completed before continuing. 


PROGRAM 
BEING. 
EXECUTED 


I/O PORTION 
OF 
PROGRAM 


I/O OPERATION 
COMPLETE 


PROGRAM 
CONTINUED 


Figure 5-1. Programmed Input/Output 
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SC/MP allows any memory-reference instruction to execute a programmed input/output operation. Peripheral 
device controllers are assigned specific memory addresses, any of which, when referenced by a memory- 
reference instruction, executes the input/output operation. It is necessary that the memory addresses assigned 
to the peripheral device be unique to the device; that is, no other peripheral device uses the same assigned 
memory addresses, nor is there memory with the same addresses. Also, the device controller must contain 
the necessary logic to decode its assigned addresses, and, then, to gate data on and off the data bus. For 
example, memory addresses X'7FFF and below might be reserved for read/write or read-only memory and 
memory addresses X'8000 to X'FFFF might be reserved for peripheral device controllers. The user, however, 
can define his own convention, as described in the SC/MP Data Sheet.’ 


The actual program steps required to enable programmed input/output depend on the design of the device 
controller. 


5.6.2 Interrupt Input/Output 


In certain cases, an input/output operation initiated by a program requires a significant length of time (many 
milliseconds) for execution; during this time, the program might perform other tasks. In other cases, the 
frequency of input/output service that requires the use of a certain input/output device might be such that it 
would be convenient for the program to ignore the device unless it specifically requires service. Each of these 
situations may be handled by taking advantage of the SC/MP interrupt system and by employing interrupt input/ 
output for devices that have interrupt capability. 


In figure 5-2, the program might initiate the input/output operation as part of its normal sequence-of-operation 
and might set a flag indicating that such action was taken. An input/output device that has interrupt capability, 
upon completion of an input/output operation, transmits an interrupt to SC/MP to indicate completion of the 
operation. 


Interrupt 


Program Executing Continue Program Execution 


Return from 
Interrupt 


Interrupt Service Program 
Services Interrupt — Clears Flag 


The flag may be employed by the original program to detérmine whether or not the input/output operation has 
been completed and whether or not the input/output device is still busy. 


Another way that an input/output operation may be initiated is to transmit an interrupt signal to the CPU. In this 
case, the program being executed is interrupted, the input/output operation is effected, and, then, the interrupted 
program is resumed. 


Interrupt 


Program Executing Continue Program Execution 


Return from 
Interrupt 


Input/Output Operation 
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PROGRAM 
INITIATES I/O 


PROGRAM 
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PROGRAM 
CONTINUES 


Figure 5-2. Interrupt Input/Output Initiation 


Interrupt input/output requires a definite and specific sequence of events, irrespective of what peripheral device 
is to be serviced; the following sequence occurs. 


1. 


SC/MP assumes that if an interrupt is to be processed, P3 contains a pointer to the interrupt 
service routine. Therefore, this pointer must be set to the proper address before interrupts 
are enabled. 


In order for an interrupt to be accepted by SC/MP, the interrupt system must be enabled. The 
system is enabled by executing an instruction after setting the Interrupt Enable (IE) flag (bit 3) 
in the status register to a'l'. The IE flag is set to 1 by the IEN (Interrupt Enable) Instruction 
or by the CAS (Copy Accumulator to Status) Instruction with a '1' in bit 3 of the accumulator. 


Once the interrupt system is enabled, a'1' in the Sense A input causes the following sequence 
of events: 


a. The instruction currently being executed is completed. 

b. Interrupts are disabled (IE cleared). Therefore, no further interrupts are accepted by 
SC/MP until interrupts are re-enabled. 

Cc. The contents of the PC are exchanged with the contents of P3. 

d. The instruction located at the location specified by the new (PC) + 1 is executed. 


The instructions at entry to the interrupt service routine must perform a number of housekeeping 
tasks before the required input/output operation can proceed. Tasks, in order of normal execution, 
are as follows: 


a. Save the contents of registers that will be used by the interrupt routine so they can be 
restored just before returning from the interrupt. Register contents are saved typically 
on a stack, usually the same stack being maintained for subroutines. 

b. Determine the source of the interrupt. The way this is done depends on the design of the 
peripheral device controllers, but, usually, controllers are designed to respond to an 
interrupt acknowledge signal by transmitting a data byte (or word) that identifies the 
source of the interrupt. This acknowledge signal could be a particular address to which 
all interrupting devices respond. 

Cc. Once the interrupt has been identified, jump to the routine that services the identified device. 
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SC/MP allows any memory-reference instruction to execute a programmed input/output operation. Peripheral 
device controllers are assigned specific memory addresses, any of which, when referenced by a memory- 
reference instruction, executes the input/output operation. It is necessary that the memory addresses assigned 
to the peripheral device be unique to the device; that is, no other peripheral device uses the same assigned 
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The actual program steps required to enable programmed input/output depend on the design of the device 
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5.6.2 Interrupt Input/Output 


In certain cases, an input/output operation initiated by a program requires a significant length of time (many 
milliseconds) for execution; during this time, the program might perform other tasks. In other cases, the 
frequency of input/output service that requires the use of a certain input/output device might be such that it 
would be convenient for the program to ignore the device unless it specifically requires service. Each of these 
situations may be handled by taking advantage of the SC/MP interrupt system and by employing interrupt input/ 
output for devices that have interrupt capability. 
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and might set a flag indicating that such action was taken. An input/output device that has interrupt capability, 
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Interrupt 


Program Executing Continue Program Execution 


Return from 
Interrupt 


Interrupt Service Program 
Services Interrupt — Clears Flag 


The flag may be employed by the original program to detérmine whether or not the input/output operation has 
been completed and whether or not the input/output device is still busy. 


Another way that an input/output operation may be initiated is to transmit an interrupt signal to the CPU. In this 
case, the program being executed is interrupted, the input/output operation is effected, and, then, the interrupted 
program is resumed. 
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Interrupt input/output requires a definite and specific sequence of events, irrespective of what peripheral device 
is to be serviced; the following sequence occurs. 


1. 


SC/MP assumes that if an interrupt is to be processed, P3 contains a pointer to the interrupt 
service routine. Therefore, this pointer must be set to the proper address before interrupts 
are enabled. 


In order for an interrupt to be accepted by SC/MP, the interrupt system must be enabled. The 
system is enabled by executing an instruction after setting the Interrupt Enable (IE) flag (bit 3) 
in the status register toa'l'. The IE flag is set to 1 by the IEN (Interrupt Enable) Instruction 
or by the CAS (Copy Accumulator to Status) Instruction with a '1' in bit 3 of the accumulator. 


Once the interrupt system is enabled, a'l' in the Sense A input causes the following sequence 
of events: 


a. The instruction currently being executed is completed. 

b. Interrupts are disabled (IE cleared). Therefore, no further interrupts are accepted by 
SC/MP until interrupts are re-enabled. 

c. The contents of the PC are exchanged with the contents of P3. 

d. The instruction located at the location specified by the new (PC) + 1 is executed. 


The instructions at entry to the interrupt service routine must perform a number of housekeeping 
tasks before the required input/output operation can proceed. Tasks, in order of normal execution, 
are as follows: 


a. Save the contents of registers that will be used by the interrupt routine so they can be 
restored just before returning from the interrupt. Register contents are saved typically 
on a stack, usually the same stack being maintained for subroutines. 

b. Determine the source of the interrupt. The way this is done depends on the design of the 
peripheral device controllers, but, usually, controllers are designed to respond to an 
interrupt acknowledge signal by transmitting a data byte (or word) that identifies the 
source of the interrupt. This acknowledge signal could be a particular address to which 
all interrupting devices respond. 

c. Once the interrupt has been identified, jump to the routine that services the identified device. 
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4, Execute input/output service routine of the selected device. 
5. Restore the appropriate register contents that were saved in step 3a. 


6. Return from the interrupt by enabling the interrupt, and then, by exchanging the return address 
in P38 (step 2c) with the program counter; thus, the execution continues at the program instruction 
following the interrupt. The following example shows the technique to insure the contents of P3 
upon return from the interrupt. 


7. The interrupt can be disabled by use of the DINT Instruction. 


ae) SKETURN: IEN sENABLE INTEKRUPTS 
3F XPPC P3 sINTERRUPT SYSTEM IS ARMED AFTER 
*THIS INSTRUCTION IS FETCHED. 
INTSVC: eee sINTEKRUPT SERVICE STARTS HEKE 
<Service Routine 
EGON’, JMP SKETURN 
LS a | USING THE STATUS REGISTER 


The status register is an 8-bit register, where 2 bits automatically reflect the result of accumulator operations; 
1 bit is the interrupt enable, and the remaining 5 bits are sense bits or user flags. The Sense-A input also 
serves as the interrupt request input. 


7 6 9) 4 3 2 1 0 
onbor[™ [fx [= fa pe 
en ey ee ee 


— User Flags 


Interrupt Enable 
Sense Inputs 
Overflow 


Carry/Link 


The status register bits are modified as indicated in table 5-1. 


Table 5-1. Status Register Bits 


Automatic Operation Special Instruction CAS Instruction 


Set/reset by arithmetic operations sets Loads from AC, bit 7 
and rotate with link resets 


Set/reset by arithmetic operations Loads from AC, bit 6 


Reflects input line Not affected, read only 


Reflects input line Not affected, read only 


Reset by interrupt IEN sets Loads from AC, bit 3 
DINT resets 


Loads from AC, bit 2 
Loads from AC, bit 1 
Loads from AC, bit 0 


All bits of the Status Register except the sense inputs can be set or cleared by the CAS Instruction. 


The CY/L and OV bits are set or cleared automatically according to the result of accumulator operations, as 
described below. CY/L also can be set by the SCL Instruction or can be cleared by the CCL Instruction. The 
IE bit is cleared automatically when an interrupt is accepted. It can be set by the IEN Instruction and can be 
cleared by the DINT Instruction. The two sense bits reflect the state applied to the external sense pins. The 
3 general-purpose flag bits are set or cleared only as directed by the CAS Instruction. 


The Status Register is a passive depository of status information, and apart from the operations described for 
CY/L, OV, and IE, all status operations (for example, testing of status or setting/clearing the overflow or 
flag bits) take place in the accumulator. Thus, the normal sequence of status-register operations is as 
follows: 


1. Transfer status to accumulator. 
2. Test/set/clear status. 
3. Return accumulator contents to status register if update is required. 


The contents of the Status Register may be tested by copying SR to AC, masking with a logical instruction, and 
testing with a conditional jump as shown in the test for overflow example below: 


06 CSA sCOPY STATUS TO AC 
D&40 ANT x'40 ;CLEAR ALL 8ITS FXCEPT 6 (9V) 
9CFB JNZ OVFL ;I1F CVERFLOW, JUMP 


Individual bits may be set or cleared using the following methods: 


06 CSA sCOPY STATUS 70 AC 
DUFF ANI X'FE °SFT UP AC TO CLRAR FO 
Dco2 ORT 2 >SET UP AC TO SFT F1 
07 CAS “CLEAR FO AND SET Fl 


5.7.1 Arithmetic Operations 


Arithmetic operations may be signed or unsigned. Consider first one byte. Unsigned, its numbering range is 
as follows: 


from 019 (X'00) = 00000000 
to 25549 (X'FF) = 11111111 


II 


Signed, the high-order bit is 0 for + (plus), 1 for - (minus), and the numbering range is as follows: 


412739 = 01111111 


019 = 00000000 


-12839 = 10000000 
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5.7.1.1 Arithmetic with Unsigned Data Bytes 
Unsigned arithmetic uses the carry bit, but not the overflow bit. For example: 


X'2E = 00101110 
+ X'52 = 01010010 


= X'80 = 10000000 CY/L=0, nocarry. Note that OV would be 
set, but the program is not concerned. 
X'AE = 10101110 
+ X'52 = 01010010 
= K'100 = 00000000 CY/L=1. Note that OV would be cleared. 


Consider the following subtraction using twos-complement arithmetic: 


X'AE - X'52 = X'AE + ~ X'52 + X'01 = X'AE + X'AD + X'01 = X'5C 


X'IAE = 10101110 
+X'AD = 10101101 
+X'01_ = 00000001 


=X'5C = 01011100 CY/L = 1 answer positive. Note that OV=1 


The code for implementing the above operation is as follows: 


C4UAE LDI OAE 
03 SCL 

PC52 CAT O52 
C8F9 ST AWS 


X'52 - X'AE = X'52 + ~ X'AE + X'01 = X'52 + X'51 + X'01 = X'A4 = -X'5C 


X'52 = 01010010 
+X'51 = 01010001 
+X'01 = 00000001 
= X'A4 = 10100100 CY/L = 0 answer negative so take twos 


II 


ones complement 
twos complement 


01011011 complement. Note OV=1. 
01011100 
=-X'5C 


Il 


The code for taking the twos complement is as follows: 


03 SCL 

01 XAF 

C400 LDI 0 
78 CAE 

0000 


Rules for addition and subtraction using unsigned data bytes are as follows: 


1. Ignore the OV bit. 


2. When adding, if CY/L is set, add 1 to the next high-order digit. CY/L is automatically an 
input to the add operation. 


3. When subtracting, if CY/Lis set, the answer is positive. If CY/L is cleared, the answer is 
negative and is present in its twos-complement form. 
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In multibyte arithmetic, the preceding three rules apply to the leftmost (terminal or high-order) byte. Between 
lower-order bytes, the CY/L bit is always treated as a carry into the low-order bit of the next byte: 


X'13E7 = 00010011 #$311100111 
+ X'24C2 = 00100100 11000010 
= X'38A9 = 00111000 10101001 


CY/L=1 
Carry into next byte 


5.7.1.2 Arithmetic with Signed Data Bytes 


Since in signed arithmetic the high-order bit represents the sign, carries out of bit 7 different from carries 
into bit 7 represent overflow. 


When performing signed arithmetic, the rules are essentially the same as for unsigned arithmetic with the 
following exceptions. 


In a single-precision (one-byte) operation, or when operating upon the most significant byte in a multibyte 
operation, the overflow (OV) flag is set when an incorrect sign bit is generated as a result of the operation. 


In performing multibyte arithmetic, the low-order byte should be processed first and any carries generated 
should be added into the next higher byte. This can be done automatically if the CY/L bit is not modified 
between the two operations. 


5. 7,2 Overflow and Carry/Link 
The overflow bit is set whenever an add or complement-and-add operation causes a different carry bit 


into bit 7 from that out of bit 7; otherwise, it is not reset. For example: 


X'5SA = 01011010 90 
+ X'75 01110101 117 
= X'CF = 11001111 = -49 © signed twos complement 


carry out of bit 6, but not out of 7 bit. 


OV set to 1. 
X'5SA = 01011010 = 90 
+ X'24 = 00100100 = £36 
=X'7E = 01111110 = 126 


No carry out of bit 6, nor out of bit 7. 
OV set to 0. 


The overflow bit is useful with signed arithmetic operations to indicate the generation of a result with an 
incorrect sign. 


In addition to being used in rotate operations when specified, the carry/link bit is set whenever an add, 
decimal add, or complement-and-add operation causes a carry out of bit 7; otherwise, it is reset. 
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5.7.2.1 Add Operation with CY/L initially reset to 0 


X'B4 = 10110100 = -T6 
+ X'D6 = 11010110 = -42 
=X'8A = 10001010 = -118 signed twos complement 
Carry out of bit 7; CY/L is set to 1. 
(Note that in this case OV would be reset. 
Ones are carried into and out of bit 7.) 
X'34 = 00110100 = o2 
+ X'56 = 01010110 = 86 
= X'8A = 10001010 = -118 signed twos complement or 138 unsigned 8-bit binary 


No carry out of bit 7; CY/L is set to 0. 
(Note that in this case OV would be set.) 


5.7.2.2 Decimal Add Operation with CY/L initially reset to 0 


(Note positive integers assumed) 


X'52 = 01010010 = 852 
+ X'186 = 10000110 = 86 
= X'38 = 00111000 = _ 38 

a, 


L_carry out of high-order digit; CY/L is set to 1. 


5.7.2.3 Complement and Add Operation with CY/L initially set to 1 


X'34 = 00110100 = 52 
+~ X'56 = X'AYQ = 10101001 = -86 
= X'DE = 11011110 = -34 


No carry out of bit 7; CY/L is set to 0. 
(Note that in this case OV would be reset to 0.) 


Chapter 6 


MACROS 


6.1 INTRODUCTION 


Programming in simple assembly language enables a user to be as efficient with his microprocessor resources 
as his capabilities allow. With assembly language, the user can specify explicitly every detail of the program 
operation: indeed, he must specify every detail. Because of this, a program in assembly language often takes 
longer to write than the same program written in a high-level language, which fills in many details automatically 
according to its internal design. This design may or may not be compatible with either the language of the ma- 
chine on which the high-level language operates or the user's problem. Ideally, the user would like a program- 
ming language that (1) most closely resembles the machine language, when it is appropriate, and (2) is ina 

form most suitable (natural) for expressing the user's problem. The language should fill in details whenever 
they are routine and should leave the user free to specify the details whenever they are crucial. This ideal can 
often be closely approximated by the use of a versatile programming tool known as macros. 


Macros are a form of text replacement that provide an automatic code-generation capability completely under 
the user's control. With macros, a user can gradually build a library tailored to his application, and, witha 
library of macros oriented toward a particular application, a user who is not a software expert can produce 
efficient maching-language code; and an experienced user can significantly reduce his program development 
time. 


6.2 BASIC MACRO CONCEPTS 


The main use of macros is to insert assembly language statements into a source program, as shown in figure 
6-1. In the example, the original source program contains a macro instruction, or macro call, named RR4. 
RR4 is a macro that rotates the Accumulator right four times. When the assembler processes RR4, it inserts 
the predefined sequence of assembly language from the macro definition named RR4 into the source program 
immediately after the point of call (RR4). The process of inserting the text of the macro definition into the 
source program is called macro expansion. The expanded macro then is processed as if it were part of the 
original source program. You will note that the macro call itself does not produce any maching language code. 
The directives used to define the limits of the macro definition (.MACRO and . ENDM) are explained in detail 
later in this chapter. 


Source Program Program Listing 
Before Assembly After Assembly 


GD6 Macro Definition 9810 JZ GD6 
GD7 for RR 9016 JMP GD7 
@1(SP) C601 LD @1(SP) 
.~.MACRO- RR4 RR4 
NUM(P1) RR 1E RR 
@1(SP) RR 1E RR 
NUM(P1) 1E RR 
1E RR 
C902 ST NUM (P1) 


C601. LD @1(SP) 
D102. AND  NUM(P1) 


Figure 6-1. Statement Insertion 
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6.3 DEFINING A MACRO 


Defining a macro means preparing the statements that constitute a macro definition. To define a macro, the 
following must be done: 


e Give it a name. 

e Declare any parameters to be used. 
e Write the statements it contains. 

e Establish its boundaries. 


The following form is used to define a macro: 


-MACRO mname [parameters] 


macro body 


- ENDM 
where: 
(1) .MACRO is the directive that initiates the macro definition. Macros must be defined before 
their use. It is legal to define a macro with the same name as an already existing macro. 
The latest definition is always the operative one, but previous definitions are not discarded. 
They may be reactivated by using the .MDEL directive to delete the last macro definition 
(see 6.12). 
(2) "mname" is the name of the macro (the name used to ''call'' the macro). The macro name 
must adhere to all rules for symbols (see 3.1.3.2). 
(3) Parameters is the optional list of parameters used in the macro definition. The list of 
parameters must adhere to all the rules for expressions (see 3.1.4). 
The following are examples of legal and illegal . MACRO directives: 
Legal Illegal Reason Illegal 
~-MACRO MAC,A,B -MACRO- SUB, $1$ Special character is used in parameter. 
~-MACRO - $ADD,OP1; OP2 ~-MACRO 1MAC,C,D First character in macro name is illegal. 
~-MACRO §LIST,$1 »>MACRO MACB, 25 First character in parameter must be 
alphabetic or $. 
~-MACRO MSG3 ~-MACRO M$AC Special character is used in macro name. 


(4) Macro body consists of assembly language statements. The macro body may contain simple 
text (see below), text with parameters (see 6.5) and macro-time operators (see 6. 5.3). 


(5) .ENDM is the directive that terminates the macro definition. 
The simplest form of a macro definition is one with no parameters or macro operators. The macro body is 
simply a sequence of assembly language statements which are substituted for each macro call. The following 


show several examples of simple macro definitions: 


sSAVE STACK POINTER 


- MACRO SSTKP —«<—————_————— Begin the macro definition 
XPAL SP 

ST STKP (P1) 

ae aa Macro body 

ST STKP+ 1 (P1) 

XPAH SP 


~-ENDM ——————_—_—_——_———— End the macro definition 


;sRESTORE STACK POINTER 


.MACRO  RSTKP 
LD STKP (P1) 
XPAL SP 

LD STKP+ 1 (P1) 
XPAH SP 

. ENDM 


sDELAY ONE MILLISECOND 


~ MACRO DELAY 
LDI 244 
DLY 0 
- ENDM 

6.4 CALLING A MACRO 


Once a macro has been defined, it then may be called. A macro is called by placing the macro name in the opera- 
tion field of an assembly language statement, and the parameters in the operand field. The following form is used 


for a macro call: 


mname [parameters] 
where 
(1) "mname" is the name previously assigned in the macro definition. 
(2) "parameters" is the list of input parameters. When a macro is defined without parameters, the 


parameter list is omitted from the call. 


A call to the delay macro, defined in 6.3, would be as follows: 
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Program Listing 


Source Program After Assembly 


Before Assembly 


: DELAY 


, C4F4 - LDI 244 
DELAY sF00 DLY 0 


USING PARAMETERS 


The power of a macro can be increased tremendously through the use of the optional parameters. 
allow variable values to be declared when the macro is called. 


6.5.1 


Macro Definition 


The parameters 


The delay macro previously illustrated could be made more powerful through the use of parameters. By making 


the delay constants depend on the call, the same macro can be used for a variety of delays. 


UCYCS is a formal parameter and can be replaced with any value at expansion time. 


sDELAY UCYCS MICROCYCLES 


MACRO DELAY2, UCYCS 
LDI UCYCS-13/2 
DLY 0 

» ENDM 


In this example, 


Parameters need not be variables or numeric values, but can be any string. The following macro, for example, 
takes an ASCII string as input and generates a message string in memory suitable for input to the SC/MP firm- 
ware MESG routine. 


- MACRO MSGSTR, LABEL,STRING 
LABEL: . ASCII 'STRING' 

. BYTE 0 

- ENDM 


The following macro generates a call to the MESG routine with the name of the message as input. 


- MACRO MESG, MSGNAM 
JS P3,07EA7 

- DBYTE MSGNAM 

» ENDM 


Note the principle here: the hexadecimal firmware address is maintained centrally in the MESG macro, not 
scattered all over the code as the macro calls will be. 


Finally, here are some macros of obvious utility in a SC/MP environment: 


;sLOAD POINTER IMMEDIATE 


. MACRO LPI, PTR, SYMB 
LDI H(SYMB) 

XPAH PTR 

LDI L(SYMB) 

XPAL PTR 

. ENDM 


;sEXCHANGE POINTER WITH MEMORY 


. MACRO EXCHP, PTR, SYMB 

LDI L(SYMB) 

XPAL PTR 

XAE 

LDI H(SYMB) 

X PAH PTR 

ST (PTR) sH(PTR) 
LDE 

ST 1(PTR) ;L(PTR) 
. ENDM 


: PROGRAM HEADER MACRO 

. MACRO PROGR, NAME, NUM, VER, DATE 
. TITLE NAME,'NUM VER DATE! 

P0=0 

Pl=1 

P2=2 

P3=3 

PC=P0 

STK PT= P2 

. ENDM 


. MACRO PUSH 
ST @-1(STKPT) 
. ENDM 


.MACRO PULL 
LD @1(STKPT) 
. ENDM 


6.5.2 Calling a Macro With Parameters 


When parameters are included in a macro call, the following rules apply to the parameter list: 


1. Commas or blanks delimit parameters. 

2. Consecutive blanks are treated as a single delimiter. 

Se A comma leading, following, or imbedded in a string of blanks is treated as a single delimiter. 
4. A semicolon terminates the list and starts the comment field. 

De Quotes may be included as part of a parameter except as the first character of a parameter. 

6. A parameter may be enclosed in quotes (') in which case the quotes are removed and the string 


is used as the parameter. This function is useful when blanks, commas, or semicolons are 
to be included in the parameter. 


7. To include a quote in a quoted parameter, it must be entered as two consecutive quotes. 


8. Missing or null parameters are treated as strings of length zero. 
The following examples illustrate these rules: 


NOTE 


In these examples, for clarity, # indicates the para- 
meter; strings are delimited by double primes (''). 


Macro Call Parameter List 
MAC1 NAME NO ONE MAN #1 "NAME" 
#2 MNO" 
#3 NONE" 
#4 "AN" 
#5,#6,. 0 mn (NULL PARAMETER) 
MAC2 MADAM 'I' 'M' ADAM #1 "MADAM" 
#9 "Tw! 
#3 "ADAM" 
#4,#5,. . mm (NULL PARAMETER) 
MAC3 'A MAN','A PLAN','A CANAL'; PANAMA 
#1 "A MAN"! 


#2 "A PLAN" 
#3 "A CANAL" 


#4,#5,... °°" (NULL PARAMETER) 
MAC4 POOR,,'IS IN A DROOP' #1 "POOR" 
#2 on" (NULL PARAMETER) 
#3 "IS INA DROOP" 
#4,#5,... °°" (NULL PARAMETER) 


The following examples show some macro calls to macros defined in 6.3. These illustrate the parameter 
parsing and substitution. 


Macro Call Generated Code 
DELAY2 100 LDI 100-13/2 
DLY 0 
MSGSTR PROMPT 'ENTER VALUE! PROMPT: ASCII 'ENTER VALUE! 
~—BYTE 0O 


6.5.3 Parameters Referenced by Number 


6.5.3.1 ‘'#!' — Number of Parameters 
'#" is a macro operator that references the parameter list in the macro call. When used in an expression, it is 
replaced by the number of parameters in the macro call. The following .IF directive, for example, causes the 


conditional code to be expanded if there are more than 10 parameters in the macro call: 


IF # 10 


6. 5. 3.2 '#N! — Nth Parameter 


When used in conjunction with a constant or variable, the '#' operator references individual parameters in the 
parameter list. The following example demonstrates how this function is used. 


- MACRO X 


- BYTE #1, #2, #2 
- ENDM 
x 3,09,2 generates ~- BYTE 3,9,2 


This relieves the need for naming each parameter in a long list and allows powerful macros to be defined using 
arbitrary numbers of parameters. 


6.5.4 'A ' — Concatenation 


The ' A ' macro operator is used for concatenation. When found, the ' A ' is removed from the output string and 
the strings on each side of the operator are compressed together after parameter substitution. If a set variable 
is used with the ' A ' operator, it is converted to a hexadecimal number before being placed in to the output 
stream. 


Example: 
. MACRO IMAGINARY, X 
RX: .BYTE 0 
IX: .BYTE 0 
. ENDM 


Another example of the use of this operator is shown in 6.9.3. 


6.6 LOCAL SYMBOLS 
- MLOC symbol[,symbol... ] [s;comments] 


When a label is defined within a macro, a duplicate definition results with the second and each subsequent call. 
The problem can be avoided by using the .MLOC directive to declare labels local to the macro definition. 


Local symbols are replaced with unique names at expansion time with ZZxxxx, where xxxx is a 4-digit hexadeci- 
mal number. The user should avoid using his own labels of the above form as it may cause duplicate definition 
errors. The .MLOC directive may occur at any point in a macro definition, but it must precede the first 
occurrence of the symbols it declares local. If it does not, no error will be reported, but symbols used before 
the .MLOC will not be recognized as local. 
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6.7 CONDITIONAL EXPANSION 


The versatility and the power of the macro assembler is enhanced by the conditional assembly directives. The 
conditional assembly directives (.IF, .ELSE and . ENDIF) from chapter 4 allow the user to generate different 
lines of code from the same macro simply by varying the parameter values used in the macro calls. Three 
relational operators are provided: 


= (equal) 
< (less than) 
> (greater than) 


6.7.1 .IF, .ELSE, . ENDIF Directives 


When the macro assembler encounters a .IF directive within a macro expansion, it evaluates the relational 
operation that follows. If the expression is satisfied (evaluated greater than 0), the lines following the .IF 

are expanded until a .ELSE or a .ENDIF directive is encountered. If the expression is not satisfied (evaluated 
less than or equal to 0), only the lines from the . ELSE to the . ENDIF are expanded. See 4.5.11 for additional 
information on the conditional assembly directives. 


Example: 
;sSHIFT THE CONTENTS OF RAM ADDRESS X 
; RIGHT IF N >0, LEFT OTHERWISE 
»- MACRO SHIFT,X,N 
LD xX 
IF N>0O 
SR 
. ELSE 
CCL 
ADD X 
. ENDIF 
ST xX 
. ENDM 
6.7.2 . IFC Directive 
[label] - IFC string] operator string2 [scomments] 


The .IFC directive allows conditional assembly based on character strings rather than the value of an expression 
as in the .IF directive. Stringl and String2 are the character strings to be compared. Operator is the rela- 
tional operator between the strings. Two operators are allowed: EQ (equal) and NE (not equal). If the rela- 


tional operator is satisfied, the lines following the .IFC are assembled until a .ELSE or a . ENDIF is encountered. 


The . ELSE and . ENDIF directives have the same effect with the .IFC directive as they do with the .IF directive. 


The primary application of the .IFC is to compare a parameter value such as #3 against a specific string. For 
example: 


.IFC #3 NE INTEGER 
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6.8 USEFUL DIRECTIVES 


6.8.1 .SET Directive 


[label] - SET symbol, expression [s;comments] 


The .SET directive is used to assign values to symbols (variables). A variable assigned a value with the .SET 
directive can be reassigned different values an arbitrary number of times. Set variables are useful during 
macro expansion to control macro-time looping and macro communication. To insure value correspondence 
between pass one and pass two of the assembler, all values in the expression must be defined before use in a 
.-SET directive. If a value is not previously defined, an error is reported and a value of zero is returned. 


The .SET directive provides what is needed to make a good DELAY macro which accepts an argument in milli- 
seconds. We define: 


M PMS=500 sMICROCYCLES PER MILLISECOND 
sDELAY MS MILLISECONDS 

:FORMULAS FROM ISP-88/994Y PAGE 4-24 

. MACRO DELAY3, MS 


.SET MC, MS*M PMS-13 

SET DLYDSP, MC/514 3(M-13)/514 

. SET CAC, 514*DLYDSP/2 

.SET CAC,MC/2-CAC ;((M-13)-514(DISP))/2 
LDI CAC 

DLY DLYDSP 

. ENDM 


Of course, this macro would benefit from a little more attention to numerical analysis, but the idea is clear: 
forget the tables and let the assembler do the arithmetic; its not only easier, its more reliable. 


6.8.2 . MDE L Directive 
[label] -MDEL mname[,mname... ] [;comments] 


The .MDEL directive deletes macro definitions from the macro definition table and frees the buffer space used 
by the definitions. 


Example: 
.MDEL DELAY, MAC1 
6.8.3 . ERROR Directive 
[label] . ERROR [string] [s;comments] 


The . ERROR directive generates an error message and an assembly error that is included in the error count at 
the end of the program. The directive is useful for parameter checking in macros. For example, the LPI macro 
defined in 6.5.1 will put out erroneous code if PTR=0, therefore, we should flag that condition. 


;LOAD POINTER (OTHER THAN PC) IMMEDIATE 
- MACRO LPI, PTR, EXPR 


IF PTR < 4 
IF PTR >0 
. SET SYMB, EXPR 
LDI H(SYMB) 
xX PAH PTR 
LDI L(SYMB) 
XPAL PTR 
.- ELSE 
IF PTR=0 
-ERROR 'LDI WILL NOT WORK WITH THE PC'! 
. ELSE 
»-ERROR ‘ILLEGAL POINTER VALUE'! 
. ENDIF 
. ENDIF 
. ENDM 
6.9 MACRO-TIME LOOPING 
6.9.1 .DO and . ENDDO Directives 
[label] -DO count [;comments] 
[label] - ENDDO [;comments] 


Macro-time looping is facilitated through the .DO and . ENDDO directives. These directives are used to delimit 
a block of statements which are repeatedly assembled. The number of times the block will be assembled is 
specified on the .DO directive. Following is the format of a .DO-.ENDDO block: 


-DO count 


NOTE 


-DO, .ENDDO, and .EXIT are defined only within 
a macro definition. 


6.9.2 . EXIT Directive 


[label] - EXIT [s;comments] 
Early termination of looping in a .DO-. ENDDO block can be effected with the . EXIT directive. 


This directive allows the current loop to finish and then terminates looping. 
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6.9.3 Examples of Macro-Time Loops 


The following examples show the use of the .DO, .ENDDO, and . EXIT directives. The macro CTAB generates 
a constant table from 0 to MAX where MAX is a parameter of the macro call. Each word has a label DX: — where 
X is the value of the data word. 


. MACRO CTAB, MAX 
-SET X,0 
-DO MAX+1 
D A X: - BYTE xX 
SET X,X+1 
. ENDDO 
. ENDM 


Now a call of the form: 
CTAB 10 


generates code equivalent to: 


- SET X, 0 
DOO: - BYTE X 

SET X,X+1 
DO1: - BYTE X 

SET X,X+1 
DO02: BYTE X 

- SET X,X+1 
DO9: - BYTE X 

SET X,X+1 
DOA: BYTE ».4 


The macro MSGLST generates a call to the SC/MP firmware MESG routine with each of the parameters on the 
macro call. The parameter list may be any length. 


- MACRO MSGLST 

. SET xX, 0 

-DO -1 sSET FOR INFINITE LOOPING 

SET X,X+1 

IF X > # s;CHECK IF NUMBER OF TIMES THRU LOOP (X) 
sIS > NUMBER OF PARAMETERS CALLED BY MSGLST 

» EXIT sYES 

- ELSE 

MESG #X sNO, CALL MESG MACRO 

- ENDIF 

« ENDDO 

- ENDM 


Now a call of the form: 


MSGLST MSG1, MSG2 


generates code equivalent to: 


JS P3,07EAT 
- DBYTE MSG1 
JS P3,07EA7 
- DBYTE MSG2 
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NOTE 


Care must be taken when writing macros that generate 
a variable number of data words through the use of the 
.IF or the .DO directives. If the operands on these 
directives are forward references, their values change 
between pass 1 and pass 2 and the number of generated 
words may change. Should this be the case, all labels 
defined after the macro call that has changed values 
generate numerous assembly errors of the following 
form: 


ERROR DUP. DEF. 


6.10 NESTED MACRO CALLS 


Nested macro calls are allowed, that is, a macro definition may contain a call to another macro. When a macro 
call is encountered during macro expansion, the state of the macro currently being expanded is saved and expan- 
sion begins on the nested macro. Upon completing expansion of the nested macro, expansion of the original macro 
continues. Depth of nesting allowed will depend on the parameter list sizes, but on the average about 10 levels of 
nesting will be allowed. 


A logical extension of a nested macro call is a recursive macro call, that is a macro that calls itself. This is 
allowed, but care must be taken that an infinite loop is not generated. 


The following macros illustrate the value of the nesting capability. The first macro is a utility macro used to load 
a pointer register. 


;sLOAD POINTER IMMEDIATE 
- MACRO LPI, PTR,SYMB 


LDI H(SYMB) 
X PAH PTR 

LDI L(SYMB) 
XPAL PTR 

. ENDM 


The next macro is named WRITE and it uses LPI to load the address of the write routine. MESG is the firmware 
address of print routine. 


sWRITE A MESSAGE 
- MACRO WRITE, MESS 


LPI P3, MESG 
X PPC P3 

- DBYTE MESS 

. ENDM 


Now 2 call to the WRITE macro 


WRITE ENDMSG 


generates the following code: 


WRITE ENDMSG 
LDI H(MESG) 
X PAH P3 
LDI L(MESG) 
XPAL P3 
X PPC P3 


-DBYTE ENDMSG 


Of course, the JS pseudo instruction could have been used instead of a macro; the number of instructions gener- 
ated is the same, but this simple case illustrates the concept. 


6-11 


6.11 NESTED MACRO DEFINITIONS 


A macro definition can be nested within another macro. Such a macro is not defined until the outer macro is 
expanded and the nested .MACRO statement is executed. This allows the creation of special-purpose macros 
based on the outer macros parameters and, when used with the .MDEL directive, allows a macro to be defined 


only within the range of the macro that uses it. 
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Chapter 7 


ASSEMBLER INPUT/OUTPUT FORMATS 


The information in this chapter is common to all the SC/MP cross assemblers. 

The SC/MP cross assembler programs assemble a source program on a host computer for subsequent execution 
by a SC/MP Microprocessor. Detailed operation instructions on the SC/MP cross assembler programs are 
contained in the installation and operating instructions for the assemblers. 

Each SC/MP cross assembler requires the following minimum complement of peripherals: a source input unit, 
a list output unit, and a binary output unit. In addition, some cross assemblers require a scratch unit that can 
be rewound for multipass processing. 


The input and output files required by the assemblers are listed below and explained in the following paragraphs. 


Logical Record 


Function File Format Length 

Source File (Input) Sequential 80 bytes 

Program Listing File (Output) Sequential 121 bytes 

Load Module File (Output) Binary 36 bytes 
Te SOURCE FILE (INPUT) 


The Source File may be input from paper tape, cards, or diskette. 


7.2 PROGRAM LISTING FILE (OUTPUT) 
The Program Listing file contains ANS FORTRAN carriage-control characters. 


At the end of the program listing, a symbol table is produced, a message is printed noting the number of errors 
discovered by the assembler program, and the source and the object checksums are printed. 


7.3 LOAD MODULE (OUTPUT) 


The Load Module (LM) file contains loading information and object code produced from the source statements. 
The LM file is an unformatted file composed of a sequence of records, each containing up to 36 bytes. The 
representation of the records depends on the storage medium. There are three types of LM records: 


Title Record (one per LM file) 
Data Record (variable number per LM file) 
End Record (one per LM file) 


The records are produced in the sequence shown in figure 7-1. Independent of the record type, the first two 
bytes in each record always have the same interpretation. The first byte specifies the record type (bits 7 and 
6) and the length of the record body (bits 5 through 0). The second byte contains a checksum for error detec- 
tion. The checksum is formed by taking the arithmetic sum (modulo 28) of all the bytes in the record body. 


Bit Position 


fi 0 
TITLE RECORD 
DATA RECORD 
DATA RECORD M 
END RECORD 


Figure 7-1. LM File Format 


0 to M Data Records 


Title Record 


The Title Record identifies the load module by name and, optionally, by a descriptive character string. These 
two items are supplied by the last . TITLE Directive statement in the source program. If the . TITLE Directive 
is not included, a default name (MAIN PR) is used. If the default program name is assigned, the descriptive 
string is empty. Figure 7-2 illustrates the format of the Title Record. 


G> © 8 ec C eee OY 


oN) 


Record 
Type 


Bit Positions 


RECORD LENGTH 


RECORD 
CHECKSUM (modulo 28) 


PROGRAM 
NAME 
DESCRIPTIVE 
STRING 
NOTES 
3 The program name and descriptive string are composed 


of 7-bit ASCII characters. The strings are right-justified 
with a zero-fill at the end. 


Ze Only the first 28 characters in the descriptive string (of 
the source statement) are used in the title record. 


Figure 7-2. Title Record Format 


T2osz2 Data Record 


The Data Records contain the actual data and instruction bytes to be loaded into memory. Each data record 
contains the load address of the initial data byte of the record. Each time a discontinuity (empty area or 
change-of-page) occurs in a program, the current record is terminated and outputted, and a new record is 
initiated. Figure 7-3 illustrates the format of the Data Record. 


Record 
Type 


7 6 5 0 Bit Position 


RECORD 
CHECKSUM (modulo 28) 


LOAD ADDRESS 


: (Bits 15-8) 
i LOAD ADDRESS 
(Bits 7-0) 
5 DATA BYTE (1) 
36 DATA BYTE (32) 


Figure 7-3. Data Record Format 


1ib<0 End Record 


The End Record marks the end of the LM file and specifies an entry address for the load module. The format 
of the End Record is illustrated in figure 7-4. 


The source checksum represents the sum (modulo 216) of all the characters, taken one ata time, in a program 
source file. The sum is printed on the program listing following the symbol table printout. 


The object sum represents the sum (modulo 216) of all the individual record checksums of the LM. This sum 
is also printed on the program listing following the symbol table. 
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Bit Position 


0 
(RECORD LENGTH) 


RECORD 
CHECKSUM (modulo 28) 


ENTRY ADDRESS 
(Bits 15-8) 


ENTRY ADDRESS 
(Bits 7-0) 


SOURCE CHECKSUM 
(Bits 15-8) 


SOURCE CHECKSUM 
(Bits 7-0) 


OBJECT CHECKSUM 
(Bits 15-8) 


OBJECT CHECKSUM 
(Bits 7-0) 


NOT USED 
(UNDEFINED) 


Figure 7-4. End Record Format 
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Appendix A 


ASCII CHARACTER SET 


Table A-1 contains the 7-bit hexadecimal code for each character in the ASCII character set. The printable 
characters in this set may be set up as program data by use of the .ASCII directive. The remaining characters 
may be set up in hexadecimal constants with a .BYTE or .DBYTE directive. Table A-2 contains the legend for 


nonprintable characters. 


Table A-1. ASCII Character Set in Hexadecimal Representation 


7-Bit 7-Bit 7-Bit 7-Bit 
Character Hexadecimal Character Hexadecimal | Character | Hexadecimal Character Hexadecimal 
Number Number Number Number 


CONS hRwWNwWeH ON: 
NMS xX Ese tTHHQTDOBR Rr pe MoO Aa oP & 


om 
re 


ESC 
DEL, RUBOUT 


@ 
| A 
B 
C 
D 
E 
F 
1G 
H 
I 
J 
K 
L 
M 
| N 
O 
P 
Q 
R 
S 
T 
‘ 
V 
WwW 
Xx 
Y 
Z 
[ 
\ 
] 
f 


Pa VW Aveo 


Table A-2. Legend for Nonprintable Characters 


NULL 
START OF READING; ALSO 
START OF MESSAGE 

START OF TEXT; ALSO EOA, 
END OF ADDRESS 

END OF TEXT; ALSO EOM, 
END OF MESSAGE 

END OF TRANSMISSION (END) 
ENQUIRY (ENQRY); ALSO WRU 
ACKNOWLEDGE. ALSO RU 
RINGS THE BELL 

BACKSPACE 

HORIZONTAL TAB 

LINE FEED OR LINE SPACE 
(NEW LINE): ADVANCES 
PAPER TO NEXT LINE 
BEGINNING OF LINE 
VERTICAL TAB (VTAB) 

FORM FEED TO TOP OF 
NEXT PAGE (PAGE) 
CARRIAGE RETURN 


SHIFT OUT 
SHIFT IN 

DATA LINK ESCAPE 
DEVICE CONTROL 1 
DEVICE CONTROL 2 
DEVICE CONTROL 3 
DEVICE CONTROL 4 
NEGATIVE ACKNOWLEDGE 
SYNCHRONOUS IDLE (SYNC) 
END OF TRANSMISSION 
BLOCK 

CANCEL (CANCL) 

END OF MEDIUM 
SUBSTITUTE 

ESCAPE. PREFIX 

FILE SEPARATOR 

GROUP SEPARATOR 
RECORD SEPARATOR 

UNIT SEPARATOR 

SPACE 


SO 


SI 


Appendix B 


INDEX OF INSTRUCTIONS 


Table B-1. Opcode Index of Instructions 


Bytes/ 


Instruction 


Mnemonic Operation ucycles 


Pulse H-flag 

Exchange AC and Extension 
Clear Carry/Link 

Set Carry/Link 

Disable Interrupts 

Enable Interrupts 

Copy Status to AC 

Copy AC to Status 

No Operation 

Serial Input/Output 

Shift Right 

Shift Right with CY/L 

Rotate Right 

Rotate Right with CY/L 
Exchange Pointer Low 
Exchange Pointer High 
Exchange Pointer with PC 
Load AC from Extension 
AND AC with Extension 

OR AC with Extension 
Exclusive-OR AC with Extension 
Decimal Add AC and Extension 
Add AC and Extension 
Complement and Add Extension to AC 8 
Delay 13-131593 
Jump 11 
Jump If Positive 9,11 
Jump If Zero 9,11 
Jump If Not Zero 9,11 
Increment and Load 22 
Decrement and Load 22 
Load 18 
Load Immediate 10 
Store 18 
AND 18 
AND Immediate 10 
OR 18 
OR Immediate 10 
Exclusive-OR 18 
Exclusive-OR Immediate 10 
Decimal Add 23 
Decimal Add Immediate 15 
Add 19 
Add Immediate 11 
Complement and Add 20 
Complement and Add Immediate 12 


AAAANMA WOAH a»eoaana an o 


em 
= 


! i 4 
_ 


- 


i ot 
mM Om a 


NDNNNYNYNNNNNNNNNNNNNNNNN BRK BE KB BE BRB Be ee eB eee PP eee BP Be ep Re 
jp 


PrP Pr PE PE PE PP SE PP LPH PP HP 


Note: XX = disp or data 


Mnemonic 


Note: XX = disp or data 


Table B-2. Mnemonic Index 


Description 


Add 


Add AC and Extension 
_ Add Immediate 
AND 


AND AC with Extension 


AND Immediate 


Complement and Add 


of Instructions 


peycles 


Complement and Add Extension to AC 


Complement and Add Immediate 
Copy AC to Status 

Clear Carry/Link 

Copy Status to AC 
Decimal Add 

Decimal Add AC and Extension 
Decimal Add Immediate 
Disable Interrupts 
Decrement and Load 
Delay 

Pulse H-flag 

Enable Interrupts 
Increment and Load 

Jump 

Jump If Not Zero 

Jump If Positive 

Jump If Zero 

Load 

Load AC from Extension 
Load Immediate 

Load Immediate 

No Operation 

OR 

OR AC with Extension 

OR Immediate 

Rotate Right 

Rotate Right 

Rotate Right with Link 
Set Carry/Link 

Shift Right 

Serial Input/Output 

Shift Right 

Shift Right with Link 
Store . 

Exchange AC and Extension 
Exclusive-OR 

Exchange Pointer High 
Exchange Pointer Low 
Exchange Pointer with PC 
Exclusive-OR AC with Extension 
Exclusive-OR Immediate 


mn 
NIoaoanaaa co ol 


a" 
ee) 


Byte/ 
Instruction 


DPE EE ENE NE BE PP BPE DEP NEP NYDN EF DYDYNYNNYNYNEP ENN EP NE NEP RPE NDE NYNNE NY DYED 


FP PP Lh PKK PH KK KP LP Lh KP SL Lh LL LP HS 


PLP EL PHL LPL BPP 


Table B-3. Numeric Index of Single-Byte Instruction Codes 


Read down then right 


.. Mnemonic and 
Description Assembler Format 
Halt 
Exchange AC and Extension 
Clear Carry/Link 

Set Carry/Link 
Disable Interrupt 
Enable Interrupt 

Copy Status to AC 
Copy AC to Status 

No Operation 

Serial Input/Output 
Shift Right 

Shift Right with Link 
Rotate Right 

Rotate Right with Link 


Exchange Pointer Low 
Exchange Pointer High 
Exchange Pointer with PC 


ptr 
X PAH ptr 
ptr 


Load AC from Extension 
AND AC with Extension 
OR AC with Extension 
Exclusive-OR AC with Extension 
Decimal Add AC and Extension 

Add AC and Extension 

Complement and Add Extension to AC 


TAY €d |} TAY @d | Tau Id Tau €d | THY @d | Tdy Td 
sJeIPOWLUW] TAY Od 


(13d)ds1po 

eyep IuX 
(19d)dsi1p YOX 
SSoIppe HOX 


(110) ds1pa 


eyep IuO 
(13d)dstp YO 
Ssorppe HO 


XXL XX9T XXSH 
XXvA 
XXEA XX¢ad XXTA 
XX0d 
XXAd XXAd xXxdd 
XXOd 
XxXdd XxXVd |: XX6d 
XX8d 


XXA0 XXHO XXdo 
. XXdO XXVO XX69 
XX80 
LZI+ 07 8ZI- = XX 
(13d)dstp dwWe 


(13d) ds1pa 

eyep INV 
(13d)ds1p CNV 
Ssorppe aNV 


(139d)dsipf 
(14d)dstp Ls 
ssorppe Ls 


(13d)ds1 po 


eyep =I ‘ICT 
(13d)dstp aT 
ssorppe al 


(13d)dsi1p gid 
ssorppe aid 
(13d)dsi1p Tl 
SsoIppe 


(13d)ds1p 
ssarppe ZNC 
(13d)dstp ZL 
SSoIppe ZL 
(13d)ds1p df 
ssorppe df 


yeWIOT Ja]quessy 
pue ouowsuyy 


Sapoyn uoTONINsSU] 9yAg-9]qQnod jO XOpuy OTEUINN ‘F-_ 21qBL 


(paxapul-oyne) YO-sAISNOXT 

dIVIPSWW] YO-2AISN[OXY 
YO-SAISN[OXy 
HYO-9AISN[OXy 


(paxepul-oyne) YO 

ayeIpowwy YO 
YO 
ie) 


(poxepul-oyne) GNV 
ayelpeumwy CNV 
aNV 

GNV 


(paxaput-ojyne) 3103S 
3103S 
a1019 


(poxepul-oyne) peoy 
ayeIpsewwy pero] 
peoy 

peoy 


peo] pue yuoulsr00q 
peo] pue juswser00eq 
peoy pue Juawes0uy 
peoTy pus Juautar9Uy 


0197, JON JJ Gung 
0197 JON JJ dune 
0197 JT dune 
0197 Jy dune 
dAT}ISOd Jt dune 
aAT}ISOg JT dune 
dune 

dune 


uo1jd1 19saq 


‘WWII Udy} puwe UMOP PROY 
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XXW4 Xxdad (13d)dstp9 

XXOuU eyep 

XXdA XXV4 (13d)dstp 

ssorppe 

LOT+ 09 8ZI- = XX 

XX9T XXGA (14d)dstpa 

XXPI eyep 

XXEA XXC4 (13d)dstp 

Sssoippe 


. XXAT XXda (4d)dstpy youd ‘ava 
XXOF eyep IVd 

( ausisun) 010 = 
Go P rea eae XxXaa XXVa (a3d)dstp youd ‘aya 
ssolppe youd ‘ava 


jaa ea €d | Tau ee a Td ee ee yeuz0g Te[QWESSY 


omy paxepuy pue ojoweuyy 


(penulju0D) sapog uoonssul o}Aq-2]qGQnoq jo xepuy olIeWNN *P-G 91GeL 


(paxopul-oyne) ppy pue yuawajdwog 
a}eIpawUlwWy] ppy pue yuawe]dwog 
Pppy pues juoweseldwuo)g 

ppy pues Juowejdwog 


(paxeput-oyne) ppy 
azeIpew wy ppy 
PPV 

PPV 


(paxapul-oyne) ppy [ewt1oeq 
a7yelpowwy ppy jew19eqd 


ppy lewtoeq 
ppy lewroeq 


uo1jd1z9seq 


"7US11 Udy} pue UMOP pROYy 
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Appendix C 


INSTRUCTION EXECUTION TIMES 


Instruction Read Write Total Instruction Read Write Total 
Cycles | Cycles | Microcycles Cycles | Cycles | Microcycles 


ADD 
ADE 
ADI 
AND 
ANE 
ANI 
CAD 
CAE 
CAI 
CAS 
CCL 
CSA 
DAD; DECA 
DAE 
DAI 
DINT 
DLD 
DLY 
HALT 
IEN 
ILD 
JMP 
INZ 


9,11 for Jump 
9,11 for Jump 
18 


11 
9,11 for Jump 


NNWHENNWHEHNHP WH RPE NEF WNE WD FE 
COFCO CrHOCOOCOCOoOCOCCoC OC eo oo oseooCoc So 
NE HEHEHE WeHE NFP HE EP EE PEP NDP We NE wD Dd 
cocooeooorcoooocoococoocoocoeoc]yae 


If slow memory is being used, the appropriate delay should be added for each read or write cycle. 


Appendix D 


DIRECTIVES 


Directive Mnemonic Operands 


Title symbol{, string] 

End . [address] 

Local 

List . immediate 

Space immediate 

Page [string] 

ASCII string[, string...] 

Byte expression[, expression... ] 

Double Byte expression[, expression...] 

Address expression[, expression...] 

Form symbol, exp[(esp)][, exp[(exp)]].. 

Set symbol, expression 
expression 

Conditional Assembly 


Macro * mname[parameters] 

End Macro * 

Macro Local * symbol[{, symbol... ] 

Do * . count 

End Do * 

Exit Do * 

Conditional Assembly stringl operator string2 (2) 
Error string 

Delete Macro mname[,mname... ] 


* Cannot be used outside a macro definition. 


NOTES: 1. The . FORM directive is not available in the SC/MP (PACE) Cross Assembler. 


2. In the . IFC directive, operator means a relational operator and may be either 
"EQ" for equal or "NE" for not equal. 


Appendix E 


PROGRAMMERS CHECKLIST 


The following list of items is suggested for desk-checking a program before assembly. 


1. 


Ze 


10. 


Is the source program terminated by an . END Directive ? 

Is each label in the program terminated by a colon (:)? 

Is each comment in the program preceded by a semi-colon (;)? 

Is each string constant in the program set off on both ends by a prime (')? 
Are all hexadecimal constants preceded by either X' or 0 (zero) ? 

For each .IF Directive in the program, is there a corresponding . ENDIF? 


Are any symbols defined by two-level forward references? This is illegal. 


Do transfer address operands consider memory page structure and PC pre-incrementation 
(before instruction fetch) ? 


Are the jumps relative to the current location specified in bytes? 
For each .MACRO directive in the program, is there a corresponding .ENDM ? 


For each .DO directive in the program, is there a corresponding . ENDDO? 


Appendix F 


CONVERSION TABLES 


Table F-1. Positive Powers of Two 


20537 6 
41075 2 


oe] 


—_ _ 
- OO OND AAW NO 


0.0625 
0.03125 


0.01562 
0.00781 
0.00390 


0.00195 
0.00097 
0.00048 


0.00024 
0.00012 
0.00006 


0.00003 
0.00001 
0.00000 


0.00000 
0.00000 
0.00000 


0.00000 
0.00000 
0.00000 


0.00000 
0.00000 
0.00000 


0.00000 
0.00000 
0.00000 


0.00000 
0.00000 
0.00000 


0.00000 
0.00000 
0.00000 


0.00000 
0.00000 
0.00000 


0.00000 
0.00000 
0.00000 


0.00000 
0.00000 
0.00000 


0.00000 
0.00000 
0.00000 


0.00000 
0.00000 
0.00000 


Table F-2. 


Negative Powers of Two 


Table F-3. Integer Conversion Table 


POWERS OF 16 


Example: 268,435,45619 = (2.68435456 x 108) 19 = 1000 00004 = (10/)46 


n 
0 
1 
2 
3 
4 
5 
6 
7 
8 
9 


Decimal Values 


The SC/MP microprocessor maintains negative numbers in twos-complement form. To convert a number in 
hexadecimal notation to its twos-complement equivalent, subtract the number from hexadecimal 2", where "n" 
is the number of binary bits in the computer word. For an 8-bit byte, 'n" is 8, and 2” is 1 0000 0000 (binary) 
or 100 (hex). 


Thus, the negative of 1C is: 


100 
1C 
E4 


A hexadecimal number will be negative in the SC/MP microprocessor if the left-most digit is 8, 9, A, B, C, 
D, E, or F (because all of these groupings start with a one). Thus, the twos-complement of C7 is 


100 
C7 
39 


Perhaps an easier way to find the twos-complement of a hexadecimal number is first to take the ones-complement 
of the number; the ones-complement’plus one is the twos-complement. The ones-complement of a number is its 
inverted form; simply exchange its ones for zeros, and its zeros for ones. Thus, 


hexadecimal binary equivalent ones-complement 


C7 1100 0111 0011 1000 


ones-complement + 1 


0011 1000 
+] 


0011 1001 
a ae 


Hex twos-complement of C7 —_ 3 9 


Table F-4. Hexadecimal and Decimal Fraction Conversion 


DECIMAL DECIMAL DECIMAL DECIMAL EQUIVALENT 


© 


4 
2 
3 
4 
5 
6 
7 
8 
9 
A 
.B 
Cc 
D- 
E 
F 


TO CONVERT .ABC HE XADECIMAL TO DECIMAL 


Find .A_ in position 1 .6250 

Find .OB inposition2 0429 6875 

Find .OOC in position3 .0029 2968 7500 
ABC Hex is equal to .6708 9843 7500 


Table F-5. Hexadecimal and Decimal Integer Conversion 


7 
HEX DECIMAL |HEX DECIMAL |HEX DECIMAL |HEX DECIMAL |HEX DECIMAL | HEX DECIMAL} HEX DECIMAL | HEX DECIMAL 
0 0 


nroooduwopvowaoannotk WN = OO 


0 
268 435 456 
536 870 912 
805 306 368 

1073 741 824 

1 342 177 280 

1610 612 736 

1879 048 192 

2 147 483 648 

2.415919 104 

2 684 354 560 

2 952 790 016 

3.221 225 472 

3 489 660 928 

3 758 096 384 

4 026 531 840 


™"MmMmOONAOWYPOAN AN AWRH = 


16 777 216 
33 554 432 
50 331 648 
67 108 864 
83 886 080 
100 663 296 
117 440 512 
134 217 728 
150 994 944 
167 772 160 
184 549 376 
201 326 592 
218 103 808 
234 881 024 
251 658 240 


0 


™mMroOONOODOpO AN DOR WHND 


0 

1 048 576 
2 097 152 
3 145 728 
4 194 304 
5 242 880 
6 291 456 
7 340 032 
8 388 608 
9 437 184 
10 485 760 
11 534 336 
12 582 912 
13 631 488 
14 680 064 
15 728 640 


0 

65 536 
131 072 
196 608 
262 144 
327 680 
393 216 
458 752 
524 288 
589 824 
655 360 
720 896 
786 432 
851 968 
917 504 
983 040 


0 0 0 


“"mroood»woipeowoanvnroanr wn = 


Oo 


T"MmMOADPHLANA NT AWDHD = 


0 0 
16 
32 


"TTMrOODpP OANA TD BWHN = 


0 
1 
2 
3 
4 
5 
6 
7 
8 
9 


TO CONVERT HEXADECIMAL TO DECIMAL TO CONVERT DECIMAL TO HEXADECIMAL 


. Locate the column of decimal numbers corresponding 


to the left-most digit or letter of the hexadecimal; 
select from this column and record the number that 
corresponds to the position of the hexadecimal digit 


. (a) Select from the table the highest decimal number 


that is equal to or less than the number to be 
converted. 
(b) Record the hexadecimal of the column con- 


or letter. taining the selected number. 


(c) Subtract the selected decimal from the number 
2. Repeat step 1 for the next (second from the left) to be converted. 


position. | 2. Using the remainder from step 1(c) repeat all of step 


1 to develop the second position of the hexadecimal 


3. Repeat step 1 for the units (third from the left) (and a remainder) 


position. 
3. Using the remainder from step 2 repeat all of step 1 


4. Add the numbers selected from the table to form to develop the units position of the hexadecimal. 


the decimal number. 4. Combine terms to form the hexadecimal number. 


To convert integer numbers greater than the capacity of table, use the techniques below: 


HEXADECIMAL TO DECIMAL DECIMAL TO HEXADECIMAL 


Successive cumulative multiplication from left to right, 
adding units position. 


Divide and collect the remainder in reverse order. 


Example: 338019 = 03416 


16 | 3380 NN remainder 


Example: D3416 = 3380109 
EXAMPLE 


= 4 
b= ae 16 uN Conversion of Decimal 
x16 EXAMPLE 3 Value 3380 
208 EXAMPLE 16 [13 5 poe 
3 = 43 Conversion of Hexadecimal D 
—_—— Value D34 
211 
16 3328 
3376 
4 = +4 4 
3380 Decimal Hexadecimal 
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